An open API service indexing awesome lists of open source software.

https://github.com/haggen/localthreat

Paste the transcript or members from chat to get a report of affiliations and PvP stats.
https://github.com/haggen/localthreat

eve-online golang react zkillboard

Last synced: 2 months ago
JSON representation

Paste the transcript or members from chat to get a report of affiliations and PvP stats.

Awesome Lists containing this project

README

        

# localthreat ![Netlify status](https://img.shields.io/netlify/f8fbdc5c-e10c-4a4d-bd13-47d261566f08?label=client+build&style=flat-square) ![Back-end deploy status](https://img.shields.io/github/workflow/status/haggen/localthreat/Back-end%20deploy?label=api+build&style=flat-square) ![CodeQL status](https://img.shields.io/github/workflow/status/haggen/localthreat/CodeQL?label=codeql&style=flat-square)

[![localthreat.xyz](screenshot.png)](https://localthreat.xyz)

---

## About

**[localthreat](https://localthreat.xyz/)** is an online tool to help EVE players with threat assessment.

## Contribution

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](https://github.com/haggen/localthreat).
- 🎨 The design lives on [Figma](https://www.figma.com/file/BPH2xeVvbBDAnWpjMI58GpnW/localthreat.next?node-id=0%3A1).
- 🐛 Bug tracking, feature requests, and other feedback must be made on the [repository's issues page](https://github.com/haggen/localthreat/issues/new/choose).

### Docker setup (recommended)

With [Docker](https://docs.docker.com/get-docker/) and [docker compose](https://docs.docker.com/compose/install/) installed , run:

```shell
docker compose up
```

This will boot everything you need in one go. Pass `-d` to free your terminal (daemon mode). You can resume your work later with the same command.

If it's your first run though, you'll need to create the database schema. Once the containers are up, run:

```shell
docker compose exec -Tu postgres db psql < api/schema.sql
```

You can access the application at http://client-localthreat.local.crz.li and the API at http://api-localthreat.local.crz.li.

> 💡 local.crz.li is a public wildcard loopback domain. It resolves to `127.0.0.1` or `::1` in IPv6.

### Manual setup

If you don't have Docker or don't want to deal with it 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:

```shell
go get
```

To download all the dependencies and then:

```shell
make
```

To test and build the binary.

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

```shell
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](https://create-react-app.dev/) written in TypeScript.

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

```shell
npm install
```

To download all the dependencies and then:

```shell
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

[The MIT License](LICENSE) © 2017 Arthur Corenzan

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.