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?
| Feature | Building from Scratch | FSS |
|---|---|---|
| Time to MVP | 4-8 weeks | 5 minutes |
| Authentication | Build from scratch | Complete JWT + MFA |
| Security | Research and implement | Enterprise-grade included |
| Database Schema | Design and implement | Production-ready Prisma schema |
| Admin Panel | Build separately | Included |
| Testing | Set up infrastructure | Jest + Cypress configured |
| Documentation | Write yourself | Comprehensive guides included |
What packages does FSS offer?
FSS consists of four main packages:
- Frontend Package - Next.js 16+ frontend with React, Tailwind CSS, and complete authentication flows
- Backend Package - NestJS backend with PostgreSQL, Redis, and comprehensive APIs
- Mobile Package - React Native/Expo mobile app for iOS and Android
- 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?
| Layer | Technology |
|---|---|
| Frontend | Next.js 16, React 19, Tailwind CSS 3.4 |
| Backend | NestJS 11, TypeScript 5, PostgreSQL 14+ |
| Mobile | React Native 0.81, Expo 54 |
| Database | Prisma ORM with PostgreSQL |
| Cache | Redis 7+ |
| Authentication | JWT, 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:
- 📧 Email: [email protected]
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?
| Aspect | Generic Starters | FSS |
|---|---|---|
| Package Options | Single full-stack | Modular (Frontend, Backend, Mobile, Admin) |
| Authentication | Basic JWT | Complete with MFA, TOTP, backup codes |
| Admin Panel | Not included | Full admin dashboard |
| Mobile App | Not included | React Native with SSO |
| Security Features | Basic | Rate limiting, CAPTCHA, audit logs |
| Observability | Not included | OpenTelemetry, Prometheus |
| Commercial Support | Community | Direct support from Bweb Solutions |
What's the difference between FSS and SaaS solutions (Firebase, Supabase, etc.)?
| Aspect | SaaS Solutions | FSS |
|---|---|---|
| Data Ownership | Vendor-owned | You own everything |
| Customization | Platform limits | Full code access |
| Vendor Lock-in | High | None |
| Cost at Scale | Expensive usage fees | Fixed infrastructure costs |
| Self-Hosting | Limited or paid | Full control |
| Compliance | Varies | Full GDPR/CCPA compliance |
| Custom Logic | Limited | Full backend flexibility |
Does FSS support AI?
Yes. FSS includes a built-in AI module supporting four providers:
| Provider | Models |
|---|---|
| Anthropic (Claude) | claude-sonnet-4-6, claude-opus-4-6, claude-haiku-4-5-20251001 |
| OpenAI | gpt-4o, gpt-4o-mini, o1, o1-mini |
| Google Gemini | gemini-2.0-flash, gemini-2.5-pro, gemini-1.5-flash |
| Groq | llama-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?
- 📖 Read the Quick Start Guide
- 🛠️ Choose your package
- 📦 Install dependencies
- 🚀 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.