{"id":46326642,"url":"https://github.com/kawser2133/saas-base","last_synced_at":"2026-03-04T16:30:33.270Z","repository":{"id":336599710,"uuid":"1134474527","full_name":"kawser2133/saas-base","owner":"kawser2133","description":"SaaSBase is an open-source foundation application designed for building large-scale, enterprise-grade, multi-tenant SaaS applications.","archived":false,"fork":false,"pushed_at":"2026-02-05T07:07:49.000Z","size":18115,"stargazers_count":4,"open_issues_count":0,"forks_count":1,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-02-05T18:57:59.441Z","etag":null,"topics":["angular","clean-architecture","dotnet-core","open-source","postgresql","redis","saas-application","saas-boilerplate","software-architecture","software-development"],"latest_commit_sha":null,"homepage":"https://binarybytez.com/saasbase-production-ready-application/","language":"C#","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/kawser2133.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-01-14T19:10:48.000Z","updated_at":"2026-02-05T14:58:18.000Z","dependencies_parsed_at":null,"dependency_job_id":"d0ae6ba5-3774-4b7e-b90e-6b4ab32dddd4","html_url":"https://github.com/kawser2133/saas-base","commit_stats":null,"previous_names":["kawser2133/saas-base"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/kawser2133/saas-base","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kawser2133%2Fsaas-base","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kawser2133%2Fsaas-base/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kawser2133%2Fsaas-base/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kawser2133%2Fsaas-base/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kawser2133","download_url":"https://codeload.github.com/kawser2133/saas-base/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kawser2133%2Fsaas-base/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30086451,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-04T15:40:14.053Z","status":"ssl_error","status_checked_at":"2026-03-04T15:40:13.655Z","response_time":59,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["angular","clean-architecture","dotnet-core","open-source","postgresql","redis","saas-application","saas-boilerplate","software-architecture","software-development"],"created_at":"2026-03-04T16:30:31.836Z","updated_at":"2026-03-04T16:30:33.254Z","avatar_url":"https://github.com/kawser2133.png","language":"C#","funding_links":["https://buymeacoffee.com/kawser"],"categories":[],"sub_categories":[],"readme":"# SaaSBase\n\n\u003cdiv align=\"center\"\u003e\n\n**🚀 Production-Ready Open-Source Foundation for Multi-Tenant SaaS Applications**\n\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n[![.NET](https://img.shields.io/badge/.NET-7.0-blue.svg)](https://dotnet.microsoft.com/)\n[![Angular](https://img.shields.io/badge/Angular-17+-red.svg)](https://angular.io/)\n[![PostgreSQL](https://img.shields.io/badge/PostgreSQL-Supported-blue.svg)](https://www.postgresql.org/)\n\n\u003c/div\u003e\n\n## 🎯 What is SaaSBase?\n\n**SaaSBase** is an **open-source foundation application** designed for building **large-scale, enterprise-grade, multi-tenant SaaS applications**. It is **not industry-specific** - anyone can use it as a foundation for their SaaS application, regardless of their business domain.\n\n![Landing Page](SaaSBase.Screenshots/Landing_Page.png)\n\n### Why SaaSBase?\n\n- ✅ **Complete Foundation**: Start with a production-ready base instead of building from scratch\n- ✅ **Multi-Tenant Ready**: Built-in organization management and tenant isolation\n- ✅ **Enterprise-Grade**: Designed for large-scale, production deployments\n- ✅ **Industry Agnostic**: Use it for any business domain - healthcare, e-commerce, education, or any SaaS idea\n- ✅ **Open Source**: Free to use, modify, and distribute under MIT License\n- ✅ **Production Ready**: Includes security, scalability, and best practices out of the box\n\n### Perfect For\n\n- 🏢 **Startups** building their first SaaS product\n- 🏭 **Enterprises** needing a solid foundation for internal tools\n- 👨‍💻 **Developers** who want to focus on business logic, not infrastructure\n- 🚀 **Teams** launching multi-tenant SaaS applications quickly\n\n## Overview\n\nSaaSBase provides a complete, production-grade foundation with enterprise features pre-built, allowing you to focus on your unique business logic. It includes:\n\n## Features\n\n### Backend: .NET 7.0 Web API\n- Clean architecture with separation of concerns\n- Entity Framework Core for database operations\n- PostgreSQL support by default (easily switchable to other databases)\n- RESTful API design\n- API versioning support\n- Swagger/OpenAPI documentation\n\n### Frontend: Angular\n- Fully integrated with authentication and authorization\n- Role-based UI components\n- Modern, responsive design\n- Standalone components architecture\n\n### Database: ORM-based (EF Core)\n- PostgreSQL by default\n- Easily switchable to other databases (SQL Server, MySQL, etc.)\n- Migration support\n- Seed data for initial setup\n\n### Authentication \u0026 Authorization\n- **Role-Based Access Control (RBAC)** fully implemented\n- JWT token authentication\n- Admin, Manager, User roles ready\n- Permission management for granular access\n- Multi-factor authentication (MFA) support\n- Password policy enforcement\n- Session management\n\n![User Management](SaaSBase.Screenshots/User_Management.png)\n\n![Role Hierarchy](SaaSBase.Screenshots/Fully_Responsive_Mobile_Version%20(2).png)\n\n### Caching \u0026 Performance\n- Redis integrated for caching frequently accessed data\n- Response caching support\n- Performance monitoring\n\n### Multi-Tenant Management (Core Feature)\n- **Complete multi-tenant architecture** built from the ground up\n- **Organization-based tenant isolation** at the data level\n- **Tenant context management** throughout the application\n- **Scalable tenant management** for large-scale deployments\n- **Organization hierarchy** support (departments, locations, positions)\n- **Tenant-specific configurations** and settings\n\n![Organization Setup](SaaSBase.Screenshots/Organization_Setup.png)\n\n![Organization Settings](SaaSBase.Screenshots/Organization_Settings.png)\n\n### Initial Organization Setup\n- Default admin user \u0026 role seeded\n- Organizational hierarchy support\n- Configurable team / department structure\n- Location management\n- Position management\n\n### Audit \u0026 Logging\n- Centralized logging with Serilog\n- Action auditing for sensitive operations\n- User activity tracking\n- Audit trail support\n\n### Extensible \u0026 Modular\n- Service layer separation\n- Dependency injection throughout\n- Modular folder structure for scaling large projects\n- Clean architecture principles\n- Repository pattern\n- Unit of Work pattern\n\n### Additional Features\n- Menu management for dynamic navigation\n- File upload and management\n- Import/Export functionality\n- Email service integration (SendGrid)\n- SMS service support\n- Notification templates\n\n![System Admin Dashboard](SaaSBase.Screenshots/System_Admin_Dashboard.png)\n\n![Profile Settings](SaaSBase.Screenshots/Profile_Settings.png)\n\n## Technology Stack\n\n### Backend (.NET)\n- **Framework**: .NET 7.0\n- **ORM**: Entity Framework Core\n- **Database**: PostgreSQL (default), easily switchable\n- **Authentication**: JWT tokens\n- **API Documentation**: Swagger/OpenAPI\n- **Logging**: Serilog\n- **Caching**: Redis\n\n### Frontend\n- **Framework**: Angular 17+\n- **Styling**: SCSS with CSS variables\n- **Icons**: Font Awesome\n- **State Management**: RxJS\n\n### Architecture Patterns\n- **Clean Architecture**\n- **Repository Pattern**\n- **Unit of Work Pattern**\n- **Dependency Injection**\n\n## Getting Started\n\n### Prerequisites\n- .NET 7.0 SDK or later\n- Node.js 18+ and npm\n- PostgreSQL (or your preferred database)\n- Redis (for caching)\n\n### Backend Setup\n1. Navigate to `SaaSBase.Api` directory\n2. Update `appsettings.json` with your database and Redis connection strings\n3. Run migrations: `dotnet ef database update`\n4. Start the API: `dotnet run`\n\n### Frontend Setup\n1. Navigate to `SaaSBase.Web` directory\n2. Install dependencies: `npm install`\n3. Update API endpoint in environment files if needed\n4. Start the development server: `npm start`\n\n### Default Credentials\n- **Email**: admin@saasbase.com\n- **Password**: Admin@123! (change on first login)\n\n## Project Structure\n\n```\nSaaSBase/\n├── SaaSBase.Api/              # Web API project\n│   ├── Controllers/           # API controllers\n│   ├── Infrastructure/       # Middleware, filters\n│   └── BackgroundServices/    # Background jobs\n├── SaaSBase.Application/       # Application layer\n│   ├── DTOs/                 # Data transfer objects\n│   ├── Services/             # Service interfaces\n│   └── Implementations/      # Service implementations\n├── SaaSBase.Domain/          # Domain models\n│   └── Enums/                # Domain enumerations\n├── SaaSBase.Infrastructure/   # Infrastructure layer\n│   ├── Persistence/          # Database context, repositories\n│   └── Services/             # Infrastructure services\n└── SaaSBase.Web/             # Angular frontend\n    └── src/\n        ├── app/\n        │   ├── core/         # Core services, guards\n        │   ├── features/     # Feature modules\n        │   └── shared/       # Shared components\n```\n\n## Security Features\n\n- JWT-based authentication\n- Role-based access control (RBAC)\n- Multi-factor authentication\n- Session management\n- Password policies\n- Data encryption at rest and in transit\n- SQL injection prevention\n- XSS protection\n- CSRF protection\n- Rate limiting\n- API versioning\n\n## Compliance\n\n- Audit trail (User activity tracking)\n- Access logging (User activity logs)\n\n## 🏗️ Architecture Highlights\n\n- **Clean Architecture**: Separation of concerns with Domain, Application, Infrastructure, and API layers\n- **Scalable Design**: Built to handle enterprise-scale workloads\n- **Extensible**: Easy to add custom features and business logic\n- **Maintainable**: Well-structured codebase following best practices\n- **Testable**: Architecture supports unit and integration testing\n\n## 🌟 Use Cases\n\nSaaSBase can be used as a foundation for:\n\n- **Healthcare SaaS**: Patient management, clinic management systems\n- **E-commerce Platforms**: Multi-vendor marketplaces, store management\n- **Education Platforms**: Learning management systems, course platforms\n- **HR \u0026 Payroll**: Employee management, payroll systems\n- **Project Management**: Team collaboration, task management\n- **CRM Systems**: Customer relationship management\n- **Any SaaS Idea**: The foundation is domain-agnostic!\n\n## 📚 Documentation\n\n- [Getting Started Guide](#getting-started)\n- [Contributing Guidelines](CONTRIBUTING.md)\n- [Security Policy](SECURITY.md)\n- [Code of Conduct](CODE_OF_CONDUCT.md)\n- [API Documentation](http://localhost:5000/swagger) (when running locally)\n\n## 🤝 Contributing\n\nWe welcome contributions! SaaSBase is an open-source project, and we're excited to have you contribute.\n\nPlease read our [Contributing Guidelines](CONTRIBUTING.md) to get started. Whether it's:\n- 🐛 Reporting bugs\n- 💡 Suggesting features\n- 📝 Improving documentation\n- 🔧 Submitting code changes\n\nEvery contribution makes SaaSBase better for everyone!\n\n## 📄 License\n\nThis project is licensed under the **MIT License** - see the [LICENSE](LICENSE) file for details.\n\nYou are free to:\n- ✅ Use SaaSBase commercially\n- ✅ Modify the code\n- ✅ Distribute your modifications\n- ✅ Use it as a foundation for your SaaS application\n\n## 🛡️ Security\n\nSecurity is important to us. If you discover a security vulnerability, please follow our [Security Policy](SECURITY.md).\n\n## 💬 Support \u0026 Community\n\n- **Issues**: [GitHub Issues](https://github.com/kawser2133/saas-base/issues)\n- **Discussions**: [GitHub Discussions](https://github.com/kawser2133/saas-base/discussions)\n- **Questions**: Open an issue with the `question` label\n\n## 👨‍💻 Author\n\n**Kawser Hamid**\n\n- 🌐 **LinkedIn**: [@kawser2133](https://www.linkedin.com/in/kawser2133/)\n- ☕ **Buy Me a Coffee**: [buymeacoffee.com/kawser](https://buymeacoffee.com/kawser)\n- 💻 **GitHub**: [@kawser2133](https://github.com/kawser2133)\n\n## 🎯 Roadmap\n\n- [ ] Enhanced documentation and tutorials\n- [ ] More authentication providers (OAuth, SAML)\n- [ ] Additional database providers\n- [ ] Kubernetes deployment guides\n- [ ] Performance optimization guides\n- [ ] More example implementations\n\n## 🙏 Acknowledgments\n\nThank you to all contributors who help make SaaSBase better!\n\n---\n\n\u003cdiv align=\"center\"\u003e\n\n**Built with ❤️ for the open-source community**\n\n**SaaSBase** - Your foundation for building enterprise-grade, multi-tenant SaaS applications.\n\n[⭐ Star us on GitHub](https://github.com/kawser2133/saas-base) | [📖 Read the Docs](#) | [🐛 Report Bug](https://github.com/kawser2133/saas-base/issues) | [💡 Request Feature](https://github.com/kawser2133/saas-base/issues)\n\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkawser2133%2Fsaas-base","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkawser2133%2Fsaas-base","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkawser2133%2Fsaas-base/lists"}