Welcome to SimexBuilder Documentation

SimexBuilder is a modern, scalable monorepo platform for building and managing simulations. This documentation covers all microservices, shared packages, and development workflows.

Architecture Overview

SimexBuilder is built as a pnpm workspace driven Turborepo with the following structure:

Applications

• Web - Main web application (port 3000)
• App - Advanced application features (port 3001)
• AARP - Advanced Analytics & Reporting Platform (port 3002)
• PWApp - Progressive Web App (port 3003)

Shared Packages

• @simexbuilder/ui - Shared UI components with Tailwind CSS v4
• @simexbuilder/auth - NextAuth v5 configuration and utilities
• @simexbuilder/database - Prisma client for PostgreSQL & MongoDB
• @simexbuilder/lib - Shared utilities and helpers
• @simexbuilder/config - Shared configurations (ESLint, TypeScript, etc.)

Quick Start

Tech Stack

• Framework: Next.js 15.5.4 with App Router
• Styling: Tailwind CSS v4
• Authentication: NextAuth v5
• Database: Prisma (PostgreSQL + MongoDB)
• UI Components: Radix UI + CVA + Framer Motion
• Monorepo: pnpm workspaces + Turborepo
• Testing: Jest, Playwright, Pact

Key Features

• 🚀 Fast Development - Hot reloading with Turbopack
• 🎨 Modern UI - Beautiful components with Tailwind CSS v4
• 🔐 Secure Auth - Enterprise-ready authentication with NextAuth
• 📦 Modular - Reusable packages across all microservices
• 🧪 Well Tested - Comprehensive test coverage
• 📱 Progressive - PWA support for mobile devices