Getting Started

Getting Started

Prerequisites

• Node.js 22+
• pnpm 10+
• Docker + Docker Compose (optional, recommended)

One-command local setup

# Clone the repo
git clone https://github.com/hieuck/Smart-ERP-Next.git
cd Smart-ERP-Next

# Install dependencies
pnpm install

# Start Postgres + Redis + API in Docker
pnpm docker:dev

# In another terminal, start the web dev server
pnpm dev:web

Open http://localhost:3000 and log in.

Without Docker

1. Install PostgreSQL 16 and create a database.
2. Copy apps/api/.env.example to apps/api/.env and fill in the connection string.
3. Run pnpm db:migrate then pnpm dev:api and pnpm dev:web.

See docs/runbooks/release-playbook.md for environment-specific details.