Release life cycle fields

.env.example

@@ -1,2 +1,2 @@
-DATABASE_URL=[REDACTED]
-PASSWORD=[REDACTED]
+DATABASE_URL=postgres://postgres:hush1234@localhost:5432?schema=feature_tracker
+PASSWORD=hush1234

CHANGELOG.md

@@ -0,0 +1,19 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+## [Unreleased]
+
+## Changed
+
+- Added release lifecycle fields ([#57]).
+
+## Fixed
+
+...
+
+## Removed
+
+...
+
+[#57]:https://github.com/stackabletech/feature-tracker/pull/57

README.md

@@ -6,29 +6,29 @@ for [Stackable](https://github.com/stackabletech).
 
 Hosted dev version available [here](https://feature-tracker.vercel.app)
 
-Install dependencies
+## Install dependencies
+
 ```
 npm i
 ```
 
+## Set up the Postgresql server
+
 Export the Postgres password (needed for the container and psql below)
-```
-export PGPASSWORD=...
-```
 
-Create .env file from .env.example
-```
-cp .env.example .env
 ```
-Edit the `.env` file with the Postgres connection string and the app password. The connection string should look like `postgres://postgres:<password>@localhost:5432` where `<password>` should match the `PGPASSWORD` env var from above.
+export PGPASSWORD=hush1234
+export PGHOST=localhost
+export PGUSER=postgres
+export PGDATABASE=postgres
+export DB_SCHEMA=feature_tracker
 
-Start Postgres in a container
 ```
-# create a volume to persist data between restarts
-docker volume create feature-tracker
 
-# start Postgres
-docker run --rm --name postgres -e PGDATA=/var/lib/postgresql/data/pgdata -e POSTGRES_PASSWORD=${PGPASSWORD} -d -p 5432:5432 -v feature-tracker:/var/lib/postgresql/data postgres:alpine
+Start Postgres in a container in the background.
+
+```
+docker run -d --name postgres -e POSTGRES_PASSWORD=${PGPASSWORD} -p 5432:5432 postgres:16.2-alpine3.19
 ```
 
 Create and populate the database
@@ -37,10 +37,13 @@ npx prisma migrate dev --name init
 psql -h localhost -U postgres -f sample/data.sql
 ```
 
-Run the app
+## Run the app
+
 ```
+cp .env.example .env
 npm run dev -- --open
 ```
+
 # Migrating the DB
 
 ## Create baseline migration