Functionalities

Welcome to the power-packed feature set of the Monorepo Boilerplate. We've crafted this platform to be Production-Ready, Scalable, and Developer-Friendly from Day 1.

Here is everything you get out of the box:

🚀 Backend Ecosystem (NestJS)

Built on the robust NestJS framework, our backend is a modular monolith designed for scale.

🛡️ Security & Authentication

• OIDC Provider: Full OpenID Connect implementation to manage identities across all your apps.
• Role-Based Access Control (RBAC): Granular permissions system with @RequirePermissions decorators and Guards.
• Two-Factor Authentication (2FA): Built-in 2FA support for enhanced security.
• Google Recaptcha v3: Integrated protection against bots on public endpoints.
• Guards & Decorators: Pre-configured guards for AccessControl, Organization, and TwoFactor.

💾 Data & Storage

• PostgreSQL & TypeORM: Enterprise-grade SQL database with powerful ORM.
• Automated Migrations: Version-controlled database schema changes (apps/api/src/common/database/migrations).
• Seeding System: Ready-to-use seeders for bootstrapping environments (apps/api/src/common/database/seeds).
• Redis Caching: High-performance caching layer using Redis/Valkey.
• S3 File Management: Secure file upload and storage abstraction compatible with AWS S3.

⚡ Core Services

• Mail Service: Transactional emails with Handlebars templates (Welcome, Reset Password, Invite).
• Worker System: Background job processing support.
• Validation: Advanced DTO validation with custom validators (e.g., IsExists, IsNotExists).

🏢 Multi-Tenancy & Whitelabeling

• Organization Management: Native support for organizations and sub-organizations.
• Whitelabeling: Custom branding (logos, colors, themes) per tenant/organization.

---

🎨 Frontend Experience (Angular)

A modern, responsive, and performance-optimized frontend application.

• Authentication Flows: Pre-built Login, Register, Forgot Password, and Reset Password pages.
• Internationalization (i18n): Native multi-language support (English/Portuguese ready).
• Organization Dashboard: Complete interface for managing organization settings and users.
• User Profile: Self-service profile management.
• Shared UI Library: Reusable components from the packages/ui workspace.

⚛️ React Micro-frontend (AI-Ready)

A complete React application integrated with the ecosystem, showcasing the power of micro-frontends.

• Full Integration: Seamlessly connected with OIDC Authentication and Organization context.
• Vercel AI SDK: Pre-configured setup for building advanced AI interfaces.
• Specialist Chatbot: Ready-to-customize chatbot foundation for building specialized AI agents.
• Framework Agnostic: Demonstrates the flexibility of the monorepo to support multiple frameworks (Angular + React) simultaneously.

---

🏗️ Infrastructure & DevOps (AWS CDK)

Stop fighting with YAML. Deploy with code using AWS Cloud Development Kit.

• Core Networking: VPC, Public/Private Subnets, NAT Gateways, and Security Groups.
• Compute: Serverless containers using AWS Fargate (ECS) or Lambda.
• Database: Managed Aurora PostgreSQL (Serverless v2 supported).
• Caching: Managed Valkey or Redis Cluster.
• Storage: Private and Public S3 Buckets.
• CDN: CloudFront distribution for lightning-fast frontend delivery.
• CI/CD Pipelines: Automated deployment pipelines using AWS CodePipeline.
• Bastion Host: Secure SSH access to your private database and resources.

---

📦 Monorepo & Tooling (Turborepo)

Orchestrated with Turborepo for extreme build speeds and developer experience.

• Shared Packages:
  • @repo/ui: Shared React/UI components.
  • @repo/shared: Shared TypeScript types, enums, and utilities.
  • @repo/eslint-config: Unified linting rules.
  • @repo/typescript-config: Centralized TS configuration.
• Documentation Site: This documentation itself! Built with Next.js and MDX (apps/docs).
• Code Quality: Pre-configured ESLint, Prettier, and Husky hooks.
• Docker Ready: Full Docker and Docker Compose setup for local development.