Run the application

How to run the application locally.

Once you have cloned the repository and installed the dependencies, you can run the application with the following commands:

pnpm init:env

This will generate a new .env file in the root directory and create a symlink to apps/web/.env.

Alternatively, you can copy the .env.example file to .env and fill in the values.

cp .env.example .env

# MacOS/Linux
ln -s apps/web/.env .env

# Windows
mklink apps/web/.env .env

Then run the following command to start the local database:

docker-compose up

Generate the initial migration files:

pnpm db:generate

Run migrate to apply the changes to the database:

pnpm db:migrate

optional If you want to seed the database with test data, run the following command:

pnpm db:seed

To run the Next.js application, run the following command:

pnpm dev:web

This will start the Next.js application at http://localhost:3000.

Authentication

The application uses Better Auth by default for authentication. Better Auth requires an AUTH_SECRET environment variable to be set.

When using the CLI to generate the .env file, a secret is automatically generated and set.

To generate a secret manually, run the following command:

openssl rand -base64 33

Now update the AUTH_SECRET environment variable in the .env file with the generated secret.

You can now log in with your email address, the confirmation URL will be printed in the console in case you haven't configured any email provider.