local-development

oaknational's avatarfrom oaknational

Development server and build commands for Oak AI project including running dev server on port 2525, production and development builds, and running scripts with environment variables. Use when starting local development, building the project, or running scripts.

⭐29stars🔀3forks📁View on GitHub🕐Updated Dec 18, 2025

When & Why to Use This Skill

This Claude skill streamlines the local development workflow for the Oak AI project by providing automated commands for starting development servers, executing builds, and managing environment variables. It simplifies monorepo navigation and script execution, ensuring a consistent and efficient environment for software engineers working with Next.js and Turborepo.

Use Cases

  • 1. Local Environment Setup: Quickly launch a Next.js development server on port 2525 with hot reloading enabled for real-time coding.
  • 2. Build Automation: Generate production-ready or development-specific builds using standardized pnpm commands to ensure deployment readiness.
  • 3. Script Execution with Context: Run TypeScript scripts with pre-loaded environment variables using 'pnpm with-env' for secure and context-aware operations.
  • 4. Monorepo Management: Efficiently target and build specific packages within a Turborepo structure using workspace filters to save time in large codebases.
namelocal-development
descriptionDevelopment server and build commands for Oak AI project including running dev server on port 2525, production and development builds, and running scripts with environment variables. Use when starting local development, building the project, or running scripts.

Local Development

Development Server

Start the Next.js development server:

pnpm dev
  • Runs on port 2525
  • Hot reload enabled

Build Commands

Production Build

pnpm build

Development Build

pnpm build:dev

Running Scripts with Environment Variables

Use pnpm with-env to run scripts with environment variables loaded:

pnpm with-env tsx src/script.ts

Monorepo Structure

This is a Turborepo monorepo using pnpm workspaces. Target specific packages with --filter:

pnpm --filter @oakai/nextjs dev
pnpm --filter @oakai/aila build