chore: update readme

Makefile

@@ -20,10 +20,10 @@ drop_db:
 		grep -q 0 || \
 		$(PSQL) -d postgres -c "DROP DATABASE $(DB_NAME)";
 
-.PHONY: migrations
-migrations: ## create the migrations
-migrations: 
-	## TODO:: use flyway for migrations
+.PHONY: migrate
+migrate: ## create the migrations
+migrate: 
+	## TODO:: this is a very basic setup, we should use flyway for migrations
 	for file in ./migrations/sql/*.sql; do \
 		printf "Applying migration: ${DB_NAME}/$$(basename $$file)\n"; \
 		$(PSQL) -d $(DB_NAME) -f $$file; \

README.md

@@ -36,6 +36,63 @@ Backend (JavaScript/TypeScript)
 - (License)[LICENSE.md]
 - (Security)[SECURITY.md]
 
+## Local Development
+
+### Prerequisites
+
+- Node.js 
+- npm
+- Docker OR PostgreSQL 15
+
+### Docker Compose
+
+To run the entire application using Docker Compose, run the following commands:
+
+```bash
+git clone [email protected]:bcgov/nr-rec-resources.git
+cd nr-rec-resources
+docker-compose up
+```
+
+Navigate to `http://localhost:3000` in your web browser to view the application.
+
+### Installation
+
+To run this on your local machine, you will need a working installation of PostgreSQL 15. 
+
+### Database
+
+Create an `.env` file in the `backend` directory using the example in `backend/.env.example` as a template.
+
+```bash
+cd nr-rec-resources
+make create_db
+make migrate
+```
+
+### Backend
+
+Ensure you have the `.env` file in the `backend` directory from the previous step.
+
+```bash
+cd backend
+npm install
+npm run dev
+```
+
+### Frontend
+
+Create an `.env` file in the `frontend` directory using the example in `frontend/.env.example` as a template.
+
+```bash
+cd frontend
+npm install
+npm run dev
+```
+
+Navigate to `http://localhost:3000` in your web browser to view the application.
+
+
 ## Style Guide
 
 Commits follow the conventions defined in the [Conventional Commits](https://www.conventionalcommits.org/en/v1.0.0/) specification.

backend/package.json

@@ -8,9 +8,9 @@
     "build": "prisma generate && nest build",
     "format": "prettier --write \"src/**/*.ts\" \"test/**/*.ts\"",
     "deploy": "npm ci --ignore-scripts --no-update-notifier && npm run build",
+    "dev": "nest start --watch",
+    "dev:debug": "nest start --debug --watch",
     "start": "nest start",
-    "start:dev": "nest start --watch",
-    "start:debug": "nest start --debug --watch",
     "start:prod": "node dist/main",
     "lint": "eslint \"{src,apps,libs,test}/**/*.ts\" --fix",
     "lint:staged": "./node_modules/.bin/lint-staged",

frontend/src/index.tsx

@@ -14,6 +14,7 @@ root.render(
   <StrictMode>
     <Header />
     <main
+      // use bcparks bootstrap theme container class to share same page max width
       className="container"
       style={{
         display: 'flex',