# Clone the repository
git clone https://github.com/AlexGustafsson/threes.git && cd threes
# Build the Docker image
docker build -t threes:latest .
# Run the image
docker run -p 3000:3000 threes
# Clone the repository
git clone https://github.com/AlexGustafsson/threes.git && cd threes
# Install dependencies
npm install
# Build the project
npm run build
# Start the server
npm run start
The project is easily run by using Docker:
docker build -t threes:latest .
docker run -p 3000:3000 threes
Or directly using npx:
npx threes
The exposed API is versioned and documented using OpenAPI in the following files:
api.v1.yml
The API specifications can be used alongside software such as Insomnia Designer or Insomnia Core or the online Swagger editor.
When run in development mode, a demo page is available to show all available styles. The demo page is available at the root of the server (/) and shown in the image at the top of this document.
Any contribution is welcome. If you're not able to code it yourself, perhaps someone else is - so post an issue if there's anything on your mind.
Clone the repository:
git clone https://github.com/AlexGustafsson/threes.git && cd threes
Set up for development:
npm install
Run the project in development mode with automatic compilation and server reload:
npm run dev
Follow the conventions enforced:
npm run lint
npm run test
npm run coverage
The project is intended for production use but is not yet heavily battle-tested. As such there may be implications when running threes in larger environments.
All styles and palettes implemented are heavily inspired by the creative work of others. Whenever possible the sources are referenced within the code. If you believe you are the creative owner of an implemented style and would like for it to be removed for any reason, please open an issue.