I accept ISK donations as contributions to the project. If you feel like localthreat has helped you please consider contributing. Send a donation in-game of any value to Jason Chorant. This helps to keep me motivated and also with the costs of running and maintaining this service.

Development

The code and documentation are hosted on GitHub. The design lives on Figma. Bug tracking, feature request, and any other feedback must be made on the repository's issues page.

Docker setup (recommended)

You'll need to be resolving any subdomain of localhost to localhost. If you're using Chrome it does that automatically. Otherwise you'll need to edit your hosts file or have something like dnsmasq.

With Docker running and docker-compose installed, run:

$ docker-compose up

This will boot everything you need in one go. You can resume your work later with the same command.

If it's your first run though, you'll need to seed the database; with the containers running:

$ docker-compose exec -T db psql -h localhost -U postgres postgres < api/schema.sql

You can access the app at http://client-localthreat.localhost and the API at http://api-localthreat.localhost.

Manual setup

If you don't have Docker or don't want to deal with proxies you can build and run everything locally.

API

It's a simple web server written in Go that talks JSON.

You'll need Go 1.15+ installed. Hop into the api/ sub-directory and run:

$ go get

To download all the dependencies and then:

$ make test
$ make

To test and build the binary.

You'll also need PostgreSQL 12+ running. Load api/schema.sql file into your database and run:

$ DATABASE_URL=postgres://postgres@localhost/postgres PORT=5000 ./api

This will start the API server. You might want to adjust the DATABASE_URL and PORT values accordingly.

Client

It's a Create React App written in TypeScript.

You'll need Node 14+ and npm installed. Hop into the client/ sub-directory and run:

$ npm install

To download all the dependencies and then:

$ REACT_APP_API_URL=http://localhost:5000 npm run-script start

To start the development server. You might want to adjust the REACT_APP_API_URL value accordingly.

Legal

EVE Online and the EVE logo are the registered trademarks of CCP hf. All rights are reserved worldwide. All other trademarks are the property of their respective owners. EVE Online, the EVE logo, EVE and all associated logos and designs are the intellectual property of CCP hf. All artwork, screenshots, characters, vehicles, storylines, world facts or other recognizable features of the intellectual property relating to these trademarks are likewise the intellectual property of CCP hf.