Skip to main content

General FAQ

What is FSS?

Full Stack Starter (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.

Why should I use FSS instead of building from scratch?

FeatureBuilding from ScratchFSS
Time to MVP4-8 weeks5 minutes
AuthenticationBuild from scratchComplete JWT + MFA
SecurityResearch and implementEnterprise-grade included
Database SchemaDesign and implementProduction-ready Prisma schema
Admin PanelBuild separatelyIncluded
TestingSet up infrastructureJest + Cypress configured
DocumentationWrite yourselfComprehensive guides included

What packages does FSS offer?

FSS consists of four main packages:

  1. Frontend Package - Next.js 16+ frontend with React, Tailwind CSS, and complete authentication flows
  2. Backend Package - NestJS backend with PostgreSQL, Redis, and comprehensive APIs
  3. Mobile Package - React Native/Expo mobile app for iOS and Android
  4. Admin Module - Built-in admin dashboard for user and system management

Can I use only part of FSS?

Yes! FSS is designed to be modular. You can use:

  • 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
  • Add Mobile - iOS and Android mobile application with backend

Is FSS production-ready?

Absolutely! FSS includes:

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

What technologies does FSS use?

LayerTechnology
FrontendNext.js 16, React 19, Tailwind CSS 3.4
BackendNestJS 11, TypeScript 5, PostgreSQL 14+
MobileReact Native 0.81, Expo 54
DatabasePrisma ORM with PostgreSQL
CacheRedis 7+
AuthenticationJWT, TOTP (MFA)

Is FSS secure?

Security is our top priority. FSS includes:

  • ✅ 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
  • ✅ Input validation and sanitization
  • ✅ SQL injection prevention with Prisma

Can I self-host FSS?

Yes! FSS is designed for self-hosting:

  • ✅ Complete Docker support
  • ✅ No vendor lock-in
  • ✅ You own your data
  • ✅ Full control over infrastructure
  • ✅ No recurring SaaS fees

How do I get support?

For issues and questions:

Is there commercial support available?

Yes! Contact Bweb Solutions LLC for:

  • Custom development
  • Priority support
  • Training and workshops
  • Enterprise licensing

How is FSS licensed?

FSS is licensed under a Commercial License. Contact Bweb Solutions LLC for licensing details and pricing.

What's the difference between FSS and other starter kits?

AspectGeneric StartersFSS
Package OptionsSingle full-stackModular (Frontend, Backend, Mobile, Admin)
AuthenticationBasic JWTComplete with MFA, TOTP, backup codes
Admin PanelNot includedFull admin dashboard
Mobile AppNot includedReact Native with SSO
Security FeaturesBasicRate limiting, CAPTCHA, audit logs
ObservabilityNot includedOpenTelemetry, Prometheus
Commercial SupportCommunityDirect support from Bweb Solutions

What's the difference between FSS and SaaS solutions (Firebase, Supabase, etc.)?

AspectSaaS SolutionsFSS
Data OwnershipVendor-ownedYou own everything
CustomizationPlatform limitsFull code access
Vendor Lock-inHighNone
Cost at ScaleExpensive usage feesFixed infrastructure costs
Self-HostingLimited or paidFull control
ComplianceVariesFull GDPR/CCPA compliance
Custom LogicLimitedFull backend flexibility

Does FSS support AI?

Yes. FSS includes a built-in AI module supporting four providers:

ProviderModels
Anthropic (Claude)claude-sonnet-4-6, claude-opus-4-6, claude-haiku-4-5-20251001
OpenAIgpt-4o, gpt-4o-mini, o1, o1-mini
Google Geminigemini-2.0-flash, gemini-2.5-pro, gemini-1.5-flash
Groqllama-3.3-70b-versatile, llama-3.1-8b-instant, mixtral-8x7b-32768

Activate any provider by adding its API key to the backend .env. The backend exposes /ai/providers, /ai/chat, and /ai/stream (SSE) endpoints. The frontend ships with drop-in AIChatInterface and AIProviderSelector components plus a useAIChat hook. The mobile app has a full aiAPI service.

See the AI Integrations Guide for setup instructions.

What are Vibe Templates?

Vibe Templates are ready-to-use code scaffolds that let you add new features in minutes:

  • Backend: vibe-templates/feature-module/ — complete NestJS CRUD module (copy, rename, run migration, register)
  • Mobile: vibe-templates/new-screen/ — complete React Native screen with service and types (copy, rename, register route)

See the Vibe Templates Guide for step-by-step instructions.

What are .context directories?

Each FSS package (backend, frontend, mobile) includes a .context/ folder containing Markdown files that describe the architecture, conventions, modules, and AI integrations of that package. These files are written specifically for AI coding agents — when you open a package in Claude Code, Cursor, or Copilot Workspace, the agent reads these files to understand the codebase without requiring you to explain it.

See the Vibe Templates Guide for more details.

How do I get started?

  1. 📖 Read the Quick Start Guide
  2. 🛠️ Choose your package
  3. 📦 Install dependencies
  4. 🚀 Run locally

Can I upgrade between packages?

Yes! FSS packages are designed to work together:

  • Frontend → Full Stack (add backend)
  • Backend → Full Stack (add frontend)
  • Any → Add Mobile package
  • Any → Add Admin module

Contact support for upgrade assistance.