How boxyhq/saas-starter-kit works
Main System Components
A. Frontend Layer
• Next.js Application (React Components)
• Authentication UI
• Team Management UI
• Account Management UI
• Billing Interface
• Webhook Management
• API Key Management
B. API Layer
• Authentication endpoints (/api/auth/*)
• Team Management endpoints (/api/teams/*)
• Webhook endpoints (/api/webhooks/*)
• SCIM endpoints (/api/scim/*)
• OAuth/SAML endpoints (/api/oauth/*)
C. Core Services Layer
• Authentication Service (NextAuth.js)
• SAML SSO Service (SAML Jackson)
• Directory Sync Service
• Webhook Orchestration (Svix)
• Audit Logging (Retraced)
• Payment Processing (Stripe)
• Email Service
D. Data Layer
• PostgreSQL Database
• Prisma ORM
• Session Management
• File Storage (for avatars)
Relationship Flows
• User authentication flows (traditional, SSO, magic link)
• Team management operations
• Webhook event propagation
• Directory synchronization
• Payment processing
• Audit log generation
External Service Integration
Integrations with:
• Stripe for payments
• Email service providers
• OAuth providers (Google, GitHub)
• SAML Identity Providers
• Svix for webhooks
• Retraced for audit logs
Implementation Details
Technical implementations:
• NextAuth.js configuration
• Prisma schema relationships
• API route structure
• Middleware placement
• Security headers
• Event handlers