Quick Start

Prerequisites

• Node.js 22 — Download
• PostgreSQL — Neon provides a free tier at neon.tech

Installation

1. Clone the Repository

git clone https://github.com/preq/projects-manager.git
cd projects-manager

2. Configure Environment

Copy .env.example to .env and fill in the required variables:

cp .env.example .env

Then edit .env:

# Required
AUTH_SECRET=<generate with: openssl rand -hex 32>
OWNER_EMAIL=your-email@example.com
OWNER_PASSWORD=<your-password>
DATABASE_URL=postgresql://...  # Your Neon connection string

# Optional
PORT=3000
ALLOWED_ORIGINS=http://localhost:3000

3. Install Dependencies

npm install

4. Apply Database Migrations

npx prisma migrate deploy

5. Start the Development Server

npm run dev

The app runs at http://localhost:3000. Log in with the email and password you set in .env.

Issue Your First API Key

1. Open http://localhost:3000 and log in
2. Navigate to Settings > API Keys
3. Click + New Token
4. Name it local-dev and save
5. Copy the token (starts with preq_)

Use this token to configure preqstation-skill on your coding agents.

Next Steps

• Kanban Board Guide — Learn task management
• Concepts — Understand the kitchen metaphor
• API Keys — Manage agent tokens