ThreeTwo!

ThreeTwo! is a comic book curation app.

⚠️ This project is in early stages of development and as such, not ready for general use.

Dependencies

ThreeTwo! currently is set up as:

The UI, this repo.
threetwo-import-service
comicvine-service
threetwo-ui-typings which are the types used across the UI, installable as an npm dependency.

Docker Instructions

The recommended approach is to simply use docker-compose which spins up containers for the UI and all the associated microservices and data store. Make sure that you have docker and docker-compose installed. Running docker system prune -a can help free up some space.

Then:

Clone this repo using git clone https://github.com/rishighan/threetwo.git
Currently, in the docker-compose setup, you will need to create the following folder structure:
```
- comics
- userdata
  |- covers
  |- expanded
  |- temporary
```
Create an external docker network using docker network create proxy
Run docker-compose up --build -d to run the containers in detatched mode
For debugging, run docker-compose up --build
Note that the first time, the process could take up to 10 minutes, since it is building containers for threetwo, threetwo-import-service, comicvine-service, mongo, nats, nginx
For posterity, check that all containers are up using docker ps

Local Development

For debugging and troubleshooting, you can run this app locally using these steps:

Clone this repo using git clone https://github.com/rishighan/threetwo.git
yarn run dev (you can ignore the warnings)
This will open http://localhost:3050 in your default browser
Note that this is simply the UI layer and won't offer anything beyond a scaffold. You have to spin up the microservices locally to get it to work.

Troubleshooting

Docker

docker-compose up is taking a long time

This is primarily because threetwo-import-service pulls calibre from the CDN and it has been known to be extremely slow. I can't find a more reliable alternative, so give it some time to finish downloading.
What folder do my comics go in?

Your comics go in the comics directory at the root of this project.

Contribution Guidelines

See contribution guidelines

2.5 KiB Raw Blame History