]> git.r.bdr.sh - rbdr/forum/blobdiff - README.md
Connect forum store to changefeed
[rbdr/forum] / README.md
index 0ab0174399336b5518872bb0c8680fe0f2f91fda..e576933091e10a6e1b2676e8a6e57bf2dddfec80 100644 (file)
--- a/README.md
+++ b/README.md
@@ -1,3 +1,37 @@
 # Forum
 
-A forum system for the year 3000
\ No newline at end of file
+A forum for the year 3000.
+
+## Running the server
+
+This project provides a [docker compose][docker-compose] configuration
+to easily run the service. In order to run the server, run
+`docker-compose up`
+
+## What you will need to get started
+
+This project uses [node][node] for most of its development processes.
+Once you have node installed according to the instructions there, run
+`npm install` from the root of the project.
+
+For local development serve the page by running `npm watch` from the
+root of the project.
+
+## Installing git hooks
+
+This repo contains a pre-commit git hook so indent will run before every
+commit. Run `npm run setup-hooks` to install it.
+
+## Running migrations on the docker environment
+
+After building the app with docker compose, you can set up the database
+with `docker exec forum_forum_1 npm run db:setup`. This will run
+migrations and seed default data.
+
+If you only want to run migrations, you should run
+`docker exec forum_forum_1 npm run db:migrate` instead.
+
+If you only want to seed the database, you should run
+`docker exec forum_forum_1 npm run db:seed` instead.
+
+[node]: https://nodejs.org/en/