How apptension/saas-boilerplate works
This repository is a React/Django/AWS SaaS starter kit. The principal workflow is a user entering the web app, authenticating and working in a tenant, with the frontend using the backend API to handle account, access-control, and product features. The graph preserves documented feature areas and one internal layer: domain models and persistence. Source excerpts are limited, so edges between feature areas and the API rely on README-level product descriptions; unsampled implementation details are not inferred.
Main entry points: schema.py Backend API · app.component.tsx Web application · models.py Tenants and RBAC · views.py Enterprise SSO
Components 19
Web experience
- Web application
packages/webapp/src/app/app.component.tsx - Feature routes
packages/webapp/src/app/config/routes.ts - API client
packages/webapp-libs/webapp-api-client/src/api/client.ts
Identity and access
- Accounts and auth
packages/backend/apps/users/views.py - Enterprise SSO
packages/backend/apps/sso/views.py - Passkeys
packages/webapp-libs/webapp-sso/src/hooks/useWebAuthn.ts - Tenants and RBAC
packages/backend/apps/multitenancy/models.py - Permission checks
packages/backend/apps/multitenancy/permissions.py
SaaS features
- Billing and subscriptions
packages/backend/apps/finances/services/subscriptions.py - Tenant backups
packages/backend/apps/backup/service.py - Content management
packages/backend/apps/content/views.py - AI assistant
packages/backend/apps/integrations/ai_assistant/views.py - Notifications
packages/backend/apps/notifications/services.py
Backend platform
- Backend API
packages/backend/config/schema.py - Background workers
packages/workers/content/handlers.py - Domain models
packages/backend/common/models.py - File storage
packages/backend/common/storages.py
Other components
- SaaS user
- Application database
Connections 25
- SaaS user → Web application: uses
README.md - Web application → Feature routes: routes via
packages/webapp/src/app/app.component.tsx - Feature routes → Web application: configures routes
packages/webapp/src/app/config/routes.ts - Web application → API client: requests data
- API client → Backend API: calls API
- Web application → Accounts and auth: supports sign-in
README.md - Web application → Enterprise SSO: supports SSO
README.md - Web application → Passkeys: offers passkeys
README.md - Web application → Tenants and RBAC: offers tenant features
packages/webapp/src/app/app.component.tsx - Web application → Billing and subscriptions: offers billing views
packages/webapp/src/app/app.component.tsx - Web application → Tenant backups: offers backup settings
packages/webapp/src/app/app.component.tsx - Backend API → Accounts and auth: serves features
- Backend API → Enterprise SSO: serves features
- Backend API → Tenants and RBAC: serves features
- Backend API → Billing and subscriptions: serves features
- Backend API → Tenant backups: serves features
- Backend API → Content management: serves features
- Backend API → AI assistant: serves features
- Backend API → Notifications: serves features
- Tenants and RBAC → Permission checks: checks permissions
packages/backend/apps/multitenancy/managers.py - Tenants and RBAC → Domain models: extends
packages/backend/apps/multitenancy/models.py - Enterprise SSO → Domain models: uses shared models
- Domain models → Application database: persists records
- Tenant backups → File storage: stores backup files
- Background workers → Backend API: runs asynchronously