|
|
@@ -0,0 +1,47 @@
|
|
|
1
|
+# :fist: SIIMEE
|
|
|
2
|
+
|
|
|
3
|
+Almost everything you need to develop.
|
|
|
4
|
+
|
|
|
5
|
+## :wrench: Tooling
|
|
|
6
|
+
|
|
|
7
|
+### Node.js and `npm`
|
|
|
8
|
+
|
|
|
9
|
+We use javascript here. `.eslintrc` and `.prettierrc` configs are provided to help make your code nice to read.
|
|
|
10
|
+
|
|
|
11
|
+### Docker and `docker-compose`
|
|
|
12
|
+
|
|
|
13
|
+Docker manages packaging for development and testing, environment variable things, and not much else.
|
|
|
14
|
+
|
|
|
15
|
+### `git`
|
|
|
16
|
+
|
|
|
17
|
+We use `git` for source control but you knew that already.
|
|
|
18
|
+
|
|
|
19
|
+## :pencil: Full Documentation
|
|
|
20
|
+See `./docs`
|
|
|
21
|
+
|
|
|
22
|
+## :battery: Installation & Getting Started
|
|
|
23
|
+1. Navigate to the `./backend` directory and run `npm install` to install backend dependencies
|
|
|
24
|
+2. Copy the server environmental variables sample file from `./server/.env.sample` and remane it to `./server/.env`
|
|
|
25
|
+3. Start the minimal `docker-compose` file provided to bootstrap a development database using the command `docker-compose --env-file ./server/.env up -d`
|
|
|
26
|
+4. Create tables and populate the database with some test data using `npm run migrate` and `npm run seed` from the `./backend` directory
|
|
|
27
|
+5. Start the backend using `npm run start`
|
|
|
28
|
+6. Navigate to the `./frontend` directory and run `npm install`
|
|
|
29
|
+7. Start the frontend development server with `npm run dev`
|
|
|
30
|
+8. User a web browser to check `http://localhost:3000`
|
|
|
31
|
+
|
|
|
32
|
+## :robot: CI/CD
|
|
|
33
|
+TBD
|
|
|
34
|
+
|
|
|
35
|
+## :satellite: Technology
|
|
|
36
|
+
|
|
|
37
|
+### Frontend
|
|
|
38
|
+See `./frontend/README.md`
|
|
|
39
|
+
|
|
|
40
|
+### Backend
|
|
|
41
|
+See `./backend/README.md`
|
|
|
42
|
+
|
|
|
43
|
+### Database
|
|
|
44
|
+Designed around `MariaDB` hosted by: [PlanetScale](https://planetscale.com)
|
|
|
45
|
+
|
|
|
46
|
+## :scroll: license
|
|
|
47
|
+UNLICENSED
|