Skip to main content

Development Guide

This guide covers development setup and workflow for the LostMind AI SaaS Platform.

Prerequisites

  • Node.js: Version 18+ with pnpm package manager
  • Database: PostgreSQL (local or hosted)
  • Redis: For caching and rate limiting
  • Google Cloud: Account for AI services and deployment
  • Environment: Unix-based system (macOS, Linux, WSL)

Quick Start

# Install dependencies
pnpm install

# Environment setup (copy and edit as needed)
# cp .env.example .env.local

# Push database schema
pnpm run db:push

# Start development servers
pnpm run dev

Development Commands

# Run specific app
pnpm run dev --filter=marketing
pnpm run dev --filter=ask

# Build all packages
pnpm run build

# Type checking
pnpm run type-check

# Run tests
pnpm run test

# Task management
pnpm run tasks:audit      # Analyze task files
pnpm run tasks:cleanup    # Remove completed tasks
pnpm run tasks:status     # Show statistics

Development Tools

Task Management System

  • Automated task lifecycle management with status tracking
  • Smart task auditing and cleanup automation
  • Format validation for consistent task structure

TypeScript Standards

  • Inheritance-aware configuration
  • Monorepo-specific patterns
  • Automated validation for configuration issues

File Organization

  • Standardized directory structures
  • Naming convention enforcement
  • Automated cleanup for project integrity

Development environment includes comprehensive tooling for professional-grade SaaS development.