cal-diy-oidc/agents/rules/reference-local-dev.md

title, impact, impactDescription, tags

title	impact	impactDescription	tags
Local Development Setup	LOW	Reference guide for local development environment	reference, development, setup

Local Development Setup

Initial Setup

# Install dependencies
yarn

# Set up environment
cp .env.example .env

Environment Variables

Generate required secrets:

# NEXTAUTH_SECRET
openssl rand -base64 32

# CALENDSO_ENCRYPTION_KEY (must be 32 characters for AES256)
openssl rand -base64 24

Configure in .env:

• DATABASE_URL - PostgreSQL connection string
• DATABASE_DIRECT_URL - Same as DATABASE_URL

Database Setup

# Development
yarn workspace @calcom/prisma db-migrate

# Production
yarn workspace @calcom/prisma db-deploy

Test Users

When setting up local development database, it creates test users. The passwords are the same as the username:

• free:free
• pro:pro

Logging

Control logging verbosity by setting NEXT_PUBLIC_LOGGER_LEVEL in .env:

• 0: silly
• 1: trace
• 2: debug
• 3: info
• 4: warn
• 5: error
• 6: fatal

API v2 Imports

If you need to import from @calcom/features or @calcom/trpc into apps/api/v2, use the platform-libraries package instead:

// ✅ Good
import { SomeService } from "@calcom/platform-libraries";

// ❌ Bad - Will cause module resolution errors
import { SomeService } from "@calcom/features/...";