feat: document how to run postgres in docker

docs/docker.md

@@ -0,0 +1,65 @@
+## Setting up Docker
+
+Bison includes a `docker-compose.yml`, `Dockerfile` and `.dockerignore`
+
+The configuration is to run a postgres database locally. 
+
+If you are interested in running the entire app, please see the examples below.
+
+## Running the Database
+
+To run postgres with docker, please add the following information to your `env` & `env.local` file.
+```
+DATABASE_URL="postgresql://dev:dev@localhost:5432/dev?schema=public"
+```
+Run `docker-compose up -d` in your terminal. If you prefer not to run in detached mode, you can remove the `-d` flag.
+
+To shut down docker, run `docker-compose down`
+
+## Using NextJS & Postgres with Docker
+
+The following configuration will help you run NextJS & Postgres. 
+
+Make sure `@prisma/client` is on version: `3.13.0`,
+
+Dockerfile
+```Dockerfile
+FROM node:lts
+WORKDIR /usr/src/app
+
+COPY package.json yarn.lock ./
+RUN yarn install
+
+COPY . .
+
+EXPOSE 3000
+
+CMD ["yarn", "dev"]
+```
+
+Add this to your services in `docker-compose.yml` file:
+```docker
+services:
+  nextjs:
+    build:
+      context: ./
+    command: bash -c "yarn db:migrate && yarn db:seed && yarn dev"
+    container_name: nextjs
+    ports:
+      - '3000:3000'
+    volumes:
+      - .:/app
+      - /app/node_modules
+```
+
+Change your database URL in your `env.local` to:
+``` 
+DATABASE_URL="postgres://dev:dev@postgres/dev?schema=public"
+```
+
+Somtimes your NextJs will not run due to postgres still booting up. You can add `connect_timeout=300` to the database URL. If you continue to have issues, you can press the `start` button in the docker application. 
+
+To run NextJs with Prisma, it is best to use `node:lts`. There are current issues with running NextJs and Prisma using `node:alpine`
+
+Run `docker-compose up -d`
+Run `docker-compose down` to shut down.

packages/create-bison-app/tasks/copyFiles.js

@@ -88,13 +88,16 @@ async function copyFiles({ variables, targetFolder }) {
         "scripts",
         "services",
         "utils",
+        ".dockerignore",
         ".eslintrc.js",
         ".hygen.js",
         ".nvmrc",
         ".tool-versions",
         "codegen.yml",
         "constants.ts",
         "cypress.json",
+        "docker-compose.yml",
+        "Dockerfile",
         "jest.config.js",
         "next-env.d.ts",
         "prettier.config.js",

packages/create-bison-app/template/.dockerignore

@@ -0,0 +1,2 @@
+node_modules
+/.data

packages/create-bison-app/template/Dockerfile

@@ -0,0 +1,15 @@
+# Default configuration to run your NextJs app locally:
+
+# FROM node:lts
+
+# WORKDIR /usr/src/app
+
+# COPY package.json yarn.lock ./
+# # COPY prisma ./prisma/
+# RUN yarn install
+
+# COPY . .
+
+# EXPOSE 3000
+
+# CMD ["yarn", "dev"]

packages/create-bison-app/template/docker-compose.yml

@@ -0,0 +1,15 @@
+version: '3.8'
+
+services:
+  postgres:
+    container_name: postgres
+    ports:
+      - 5432:5432
+    image: postgres:14
+    environment:
+      POSTGRES_USER: dev
+      POSTGRES_PASSWORD: dev
+      POSTGRES_DB: dev
+    restart: always
+    volumes:
+      - ./.data/postgres:/var/lib/postgresql/data