Skip to main content

Full Stack Starter (FSS) Documentation

Welcome to the Full Stack Starter (FSS) documentation! FSS is a comprehensive, production-ready full-stack solution built by [Bweb Solutions LLC]. It provides a complete foundation for building modern web and mobile applications with enterprise-grade security, authentication, and user management features out of the box.

FSS Architecture Overview

What is FSS?​

FSS is designed as a modular system with four main packages that can be used independently or together:

PackageDescription
Frontend PackageNext.js 16+ frontend with React, Tailwind CSS, and complete authentication flows
Backend PackageNestJS backend with PostgreSQL, Redis, and comprehensive APIs
Mobile PackageReact Native/Expo mobile app for iOS and Android
Admin ModuleBuilt-in admin dashboard for user and system management

Core Philosophy​

FSS follows these core principles:

  • Security First - Enterprise-grade security with MFA, rate limiting, audit logging, and secure token handling
  • TypeScript Throughout - Full type safety from backend to frontend to mobile
  • Modern Stack - Built with latest technologies: Next.js 16, NestJS 11, React Native 0.81
  • Production Ready - Docker support, monitoring, observability, and deployment scripts
  • Developer Experience - Clear structure, comprehensive documentation, and testing infrastructure
  • AI-Ready - Multi-provider AI integrations (Claude, OpenAI, Gemini, Groq) available across all packages
  • Vibe Coding - Built-in templates and .context directories that let AI coding agents understand each package instantly

System Architecture​

Quick Start​

Get up and running with FSS in minutes:

# Clone the repository
Download and extract the FSS package from the FSS dashboard.
cd fss

# Install dependencies
cd projects/fss/backend
npm install

# Set up environment variables
cp .env.example .env

# Start development server
npm run start:dev

Package Selection​

Depending on your needs, choose the appropriate package:

  • Frontend Only - Already have a backend? Get the Next.js UI with authentication
  • Backend Only - Need APIs and authentication for your frontend
  • Full Stack - Complete web application with frontend and backend
  • Mobile App - iOS and Android mobile application with backend

Features​

🔐 Enterprise-Grade Security​

  • JWT-based authentication with access/refresh tokens
  • Multi-Factor Authentication (MFA) with TOTP
  • Session management with Redis
  • Rate limiting and brute-force protection
  • Content Security Policy (CSP) with nonces
  • Comprehensive audit logging

🚀 Modern Tech Stack​

  • Frontend: Next.js 16, React 19, Tailwind CSS 3.4
  • Backend: NestJS 11, TypeScript 5, PostgreSQL 14+, Redis 7+
  • Mobile: React Native 0.81, Expo 54
  • Database: Prisma ORM with PostgreSQL

📦 Production Ready​

  • Docker and Docker Compose support
  • NGINX reverse proxy configuration
  • SSL/TLS certificates setup
  • Health checks and monitoring
  • Automated backup and restore scripts

🛠️ Developer Experience​

  • Full TypeScript support across all packages
  • Comprehensive API documentation (Swagger)
  • Jest and Cypress testing configured
  • ESLint and Prettier code formatting
  • Clear project structure

🤖 AI Integrations​

  • Multi-provider support: Anthropic (Claude), OpenAI (GPT), Google (Gemini), Groq
  • Zero-config by default — activate providers by adding API keys
  • REST endpoints: GET /ai/providers, POST /ai/chat, POST /ai/stream (SSE)
  • Drop-in React components (AIChatInterface, AIProviderSelector) and useAIChat hook
  • Mobile AI service with full-response support
  • Extensible IAIProvider interface for adding custom providers

🧠 Vibe Coding & .context Directories​

  • Each package ships with a .context/ folder of Markdown files describing architecture, conventions, modules, and AI integrations
  • AI agents (Claude Code, Cursor, Copilot Workspace) can read these files for instant codebase understanding
  • Vibe templates for backend (NestJS CRUD module) and mobile (React Native screen) scaffold new features in minutes

Documentation Structure​

The documentation is organized into the following sections:

  1. Getting Started - Quick start guides and installation
  2. Packages - Documentation for each FSS package
  3. Configuration - Environment setup and configuration
  4. Core Concepts - Architecture and design patterns
  5. Add-ons - Optional modules and extensions
  6. Guides - How-to guides and tutorials, including:
  7. API Reference - Complete API documentation
  8. FAQ - Frequently asked questions

Support​

For issues and questions:

License​

FSS is licensed under the Commercial License. Contact Bweb Solutions LLC for licensing inquiries at https://bweb.solutions or [email protected].

Built with ❤️ by Bweb Solutions LLC