Skip to main content

​
Prerequisites

Before you begin, ensure you have the following installed:
ToolVersionInstall
Node.js20+nodejs.org
pnpm10+corepack enable && corepack prepare pnpm@latest --activate
Supabase CLILatestpnpm add -g supabase
Git2.40+git-scm.com
Node 18 is not supported. Next.js 15 and several dependencies require Node 20 or later.

​
Clone and Install

1

Clone the repository

git clone git@github.com:your-org/securatlas.git
cd securatlas
2

Install dependencies

pnpm install
This installs all workspace packages including apps/web and everything under packages/*.
3

Link to Supabase project

supabase link --project-ref hcyyegiialkkjcdxpfat
You will be prompted for your Supabase access token. Generate one at supabase.com/dashboard/account/tokens.

​
Environment Variables

Copy the example env file and fill in values: 
cp apps/web/.env.example apps/web/.env.local
At minimum, set these in .env.local: 
NEXT_PUBLIC_SUPABASE_URL=https://hcyyegiialkkjcdxpfat.supabase.co
NEXT_PUBLIC_SUPABASE_ANON_KEY=your_anon_key
SUPABASE_SERVICE_ROLE_KEY=your_service_role_key
NEXT_PUBLIC_APP_URL=http://localhost:3000
See the Environment Variables page for the complete list of all required and optional variables.

​
Run the Dev Server

pnpm dev
This starts the Next.js 15 development server on http://localhost:3000 with Turbopack.
The monorepo uses pnpm workspaces. The dev script in the root package.json delegates to apps/web.

​
Supabase Local Development (Optional)

To run Supabase locally for offline development: 
supabase start
This spins up local PostgreSQL, Auth, Storage, and Edge Functions containers via Docker. Update your .env.local to point to the local endpoints printed by supabase start.

​
Common Issues

Run with the --no-strict-peer-dependencies flag or ensure you are on pnpm 10+. The workspace is configured for pnpm 10 resolution behavior.
Kill the existing process or start on a different port:
pnpm dev -- --port 3001
Run the full build once to generate types:
pnpm build
Then restart your IDE to pick up generated Supabase types.
Ensure Docker is running and you have started Supabase locally with supabase start. Edge Functions require the Deno runtime container.