Skip to content

Getting Started

1. Install Dependencies

First, install the project dependencies using pnpm:

bash
pnpm install

This will download all required packages listed in package.json.

2. Start MongoDB and Valkey (Redis equivalent) Locally with Docker

Next, you need to run MongoDB and Valkey (a Redis-like service) locally using Docker.

Make sure you have Docker and Docker Compose installed.

Start the services with:

bash
docker-compose up

This will:

  • Launch a MongoDB container with pre-seeded data for development.
  • Launch a Valkey container (used as a Redis alternative).

3. Connect to AWS

The app uses the AWS SDK for certain features, so make sure you're connected to AWS locally to avoid errors.

Steps:

  1. Install AWS CLI (if not already installed):

Aws Documentation

  1. Configure AWS CLI:

    Run the following command and enter your AWS credentials:

    bash
    aws configure

    This will ask for your Access Key ID, Secret Access Key, Region, and Output Format.

4. Set Up Environment Variables

Copy the .env.development file to .env to configure your local environment:

bash
cp .env.development .env

5. Start the Server

Finally, start the development server:

bash
pnpm run dev

This will launch the server and you should be able to access the app locally.


Notes:

  • If you encounter errors, check the console logs. If there are any AWS-related errors, it usually means you're not properly authenticated with AWS.
  • Ensure that Docker is running when using docker-compose up.

That's it! Your local development environment should now be set up.