Developer Onboarding
Get your local environment up and running in under 10 minutes.
1. Prerequisites
Ensure you have the following installed:
Node.jsv20+
JavaScript runtime
PNPMv9+
npm install -g pnpm
Docker DesktopLatest
Required for local Supabase
Supabase CLILatest
brew install supabase/tap/supabase
2. Environment Variables
cp .env.example .env.localNote: Ask the lead developer for development API keys if you don't have access to the Supabase dashboard or Shopier credentials.
3. Database Setup (Supabase)
Start the local Supabase stack (make sure Docker is running):
Start local Supabase
supabase startGenerate TypeScript types (optional)
pnpm run build:types4. Install & Run
pnpm install
pnpm dev5. Port Map
| Service | Port | Command |
|---|---|---|
| Web Storefront | 3000 | pnpm dev:web |
| Admin Dashboard | 3001 | pnpm dev:dashboard |
| Docs (Swagger) | 3002 | pnpm dev:docs |
| Discord Bot | 8787 | pnpm dev:discord |
| Telegram Bot | 8788 | pnpm dev:telegram |
6. Next Steps
Now that your app is running locally, read these documents to understand the system: