https://www.findmomentum.xyz

A productivity app that helps track and celebrate daily progress through small wins.

Installation

1. Clone the repository

2. Install nvm (Node Version Manager)

3. Install and use the correct Node.js version

nvm install
nvm use

4. Install dependencies

npm install

5. Set up the environment variables:

• Copy the .env.example file to .env:

cp .env.example .env

• Open the .env file and fill in the necessary environment variables, including your PostgreSQL database URL

6. Set up Prisma and the database:

• Generate Prisma client:

npx prisma generate

• Run migrations:

npx prisma migrate dev

These commands will set up your database schema and apply all existing migrations.

7. Start the development server

npm run dev

Testing

1. Create the test database:

createdb momentum_test

2. Add DATABASE_TEST_URL to your .env file pointing at it:

DATABASE_TEST_URL=postgresql://localhost/momentum_test

The database name must contain the word "test". The test setup file refuses to truncate any database that doesn't, protecting your development data.

3. Run the full suite once:

npm test

Or run in watch mode during development:

npm run test:watch

Note: npm test and npm run test:watch require bash (the test:setup script uses bash variable expansion to re-export DATABASE_TEST_URL as DATABASE_URL before migrating). macOS and Linux users have this by default. Windows users should use WSL2 or Git Bash.