This repository serves as a sandbox for experimenting with oddlaws data applications
We try not to be too strict about contributing guidelines. We encourage you to contribute in any way you can, whether it's by submitting bug reports, feature requests, or pull requests.
There's a basic pull request template that you can use when submitting a pull request. We have some issues outlined but they're not exhaustive, contribute to the project as you see fit.
The project is MIT licensed, so feel free to use it in your own projects.
- Node >= 23
- A PostgreSQL database
We recommend using Docker to run the PostgreSQL database. You can start a PostgreSQL container with the following command:
docker run --name oddlaws-postgres -e POSTGRES_PASSWORD=postgres -e POSTGRES_DB=oddlaws -p 5432:5432 -d postgres
- Copy the
.env.example
file to.env
and fill in the database credentials (if you used the above command, the defaults should work) - Run
yarn install
to install the dependencies - Run
yarn db:migrate
to create the database tables - Run
yarn dev
to start the development server
Merges into main
currently deploy to the staging site, but I (sneakycrow) am happy to setup a few other
environments for you if you need one.