StartupGenie - AI Startup Workspace Platform

Overview

StartupGenie is an AI-powered platform designed to transform business ideas into comprehensive startup packages. It leverages a multi-agent AI system to generate essential deliverables such as Product Requirements Documents (PRDs), starter code, investor pitch decks, marketing strategies, and launch content. The platform's primary goal is to provide rapid prototyping capabilities and professional-grade startup materials for founders and entrepreneurs.

User Preferences

Preferred communication style: Simple, everyday language.

System Architecture

Frontend

• Technology Stack: React 18, TypeScript, Vite, Wouter, TanStack Query, shadcn/ui (on Radix UI), Tailwind CSS.
• Design System: Hybrid (Linear + Notion) with HSL-based theming (light/dark modes), Inter and JetBrains Mono typography, consistent spacing, and CSS-based elevation.
• Key UI Patterns: Multi-stage generation flow, real-time AI agent progress visualization, modal content viewing, and a responsive dashboard with card displays.

Backend

• Hybrid Architecture:
  • Node.js/Express Service (Port 5000): Handles primary API, authentication, sessions, user-facing APIs, serves frontend, and proxies AI requests.
  • Python/FastAPI Service (Port 8000): Orchestrates AI agents using CrewAI, integrates OpenAI GPT-4o via LangChain, and updates PostgreSQL directly for status.
• Authentication & Session Management: Passport.js with OpenID Client for Replit Auth, PostgreSQL session store, and secure HTTP-only cookies.
• Anonymous Access: Supports both authenticated and anonymous users by tracking userId or sessionId, with session configuration ensuring persistence.

Data Storage & Schema

• Database: PostgreSQL via Drizzle ORM.
• Core Tables: sessions, users, startupIdeas.
• Schema Management: Drizzle Kit for migrations, type-safe queries, and Zod for runtime validation.

AI Agent System (CrewAI)

• Overview: Coordinates 6 specialized AI agents, powered by OpenAI's GPT-4o, to create startup packages.
• Agents: Market Research Analyst, Product Requirements Specialist, Software Architect, Code Generation Agent, Pitch Deck Creator, and Marketing Strategist.
• Execution Flow: Sequential phase (Market Research, Product Requirements, Software Architect) followed by a parallel phase (Code Generation, Pitch Deck, Marketing Strategy).
• Artifact Generation: Automatically generates downloadable artifacts like PRD PDFs (with user journeys), UI mockups (DALL-E generated), investor pitch decks (PPTX with AI visuals), market analysis reports, competitor matrices, user personas, architecture diagrams, database schemas, and starter code packages.

External Dependencies

• Authentication: Replit Auth (OpenID Connect provider).
• Database: Neon Database (serverless PostgreSQL).
• Frontend UI: shadcn/ui.
• AI Model: OpenAI GPT-4o, DALL-E 3.
• AI Agent Tools: Perplexity AI (for market research).
• Development Tools (Replit-specific): @replit/vite-plugin-runtime-error-modal, @replit/vite-plugin-cartographer, @replit/vite-plugin-dev-banner.
• Build & Tooling: Vite, esbuild, tsx, PostCSS.
• State Management & Data Fetching: TanStack Query.
• Validation & Forms: Zod, React Hook Form, @hookform/resolvers.