> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lostmindai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# LostMind AI - SaaS Platform Development - Architecture

> architecture documentation for LostMind AI - SaaS Platform Development

# Architecture Overview

## System Overview

The LostMind AI SaaS Platform is a production-ready AI-powered platform built with Next.js 15, Turborepo, and FastAPI. The architecture focuses on scalable microservices, modern development practices, and seamless AI integration.

## Key Components

* **Frontend Applications**: Next.js 15 apps (Ask, Marketing) with React 19
* **Backend Services**: FastAPI microservices for AI computation
* **Database Layer**: PostgreSQL with Prisma ORM and Row Level Security
* **AI Integration**: Google Generative AI (Gemini) with unified client
* **Authentication**: Auth.js v5 with Google OAuth
* **Payment Processing**: Stripe integration
* **Monorepo Management**: Turborepo with pnpm workspaces

## Technical Stack

### Frontend

* **Framework**: Next.js 15 with App Router
* **UI Library**: React 19 Stable
* **Language**: TypeScript
* **Styling**: Modern CSS-in-JS solutions

### Backend

* **API Framework**: FastAPI (Python)
* **Database**: PostgreSQL
* **ORM**: Prisma with Row Level Security
* **Caching**: Redis
* **Authentication**: Auth.js v5

### AI & Services

* **AI Provider**: Google Generative AI (Gemini)
* **Payment**: Stripe
* **Deployment**: Vercel (Frontend), Google Cloud Run (Backend)
* **Monitoring**: Comprehensive logging and analytics

## Design Decisions

### Monorepo Structure

* **Tool**: Turborepo for efficient build and dependency management
* **Package Manager**: pnpm for workspace optimization
* **Organization**: Clear separation between apps, packages, and services

### Microservices Architecture

* **Separation of Concerns**: Frontend and AI compute services are decoupled
* **Scalability**: Independent scaling of frontend and backend services
* **Development**: Parallel development of different service components

### Security First

* **Authentication**: Robust OAuth implementation with Auth.js
* **Database**: Row Level Security in PostgreSQL
* **API**: Secure FastAPI endpoints with proper validation
* **Secrets**: Environment-based secret management

***

*Architecture reflects the current production-ready state with ongoing enhancements for scalability and performance.*