Skip to main content
OrgStack hero

What is OrgStack?

OrgStack is a starter template for building multi-tenant organization management platforms with Spring Boot and Angular. It provides a foundational architecture designed for strict tenant isolation, authentication, and authorization patterns.
OrgStack is currently in early development. The architecture and patterns described in this documentation represent the planned implementation. See the architecture guide for details on the intended design.

Multi-tenant architecture

Designed for strict tenant isolation patterns to ensure data security across organizations.

Spring Boot foundation

Built on Spring Boot 4.0.3 with Spring Security, Spring Data JPA, and PostgreSQL.

Clean architecture

Structured for layered architecture following Spring Boot best practices.

Developer starter

Includes audit logging foundation with JPA auditing and Docker Compose setup.

Get started

1

Start with the quickstart

Follow our quickstart guide to get OrgStack running locally in minutes.
2

Understand core concepts

3

Explore the architecture

Dive into the architecture guide to understand how OrgStack is structured.

Foundation components

Base entity with audit logging

OrgStack provides a BaseEntity class that all domain entities can extend. It includes UUID-based identifiers and automatic timestamp tracking using JPA auditing.
BaseEntity.java
@MappedSuperclass
@EntityListeners(AuditingEntityListener.class)
@Getter
public class BaseEntity {
    @Column(nullable = false, updatable = false)
    private UUID id;
    
    @CreatedDate
    @Column(nullable = false, updatable = false)
    private Instant createdAt;
    
    @LastModifiedDate
    @Column(nullable = false)
    private Instant updatedAt;

    protected BaseEntity() {
        this.id = UUID.randomUUID();
    }
}

JPA auditing configuration

Automatic tracking of creation and modification timestamps on all entities using JPA auditing.
JpaConfig.java
@Configuration
@EnableJpaAuditing
public class JpaConfig {
}

Technology stack

Backend

Spring Boot 4.0.3 with Spring Security, Spring Data JPA, and PostgreSQL

Frontend

Angular with Spartan NG component library

Backend technologies

  • Java 25 - Modern Java features and performance
  • Spring Boot 4.0.3 - Latest Spring framework
  • Spring Security - Enterprise-grade security
  • Spring Data JPA - Database abstraction with Hibernate
  • PostgreSQL 16 - Reliable relational database
  • Maven - Dependency management
  • Lombok - Reduce boilerplate code

Frontend technologies

The frontend directory is currently a placeholder for planned Angular integration with Spartan NG components.

Intended use cases

This starter template is designed for building:
  • Multi-tenant SaaS platforms that need organization-based isolation
  • B2B applications with organization-scoped access
  • Enterprise tools requiring strict data separation
  • Customer portals with role-based permissions
  • Team collaboration tools with audit trails
The architecture documentation describes the intended patterns for implementing these use cases. The current codebase provides the foundational infrastructure.

Next steps

Quickstart

Get OrgStack running locally in under 5 minutes

Multi-tenancy concepts

Learn how OrgStack implements tenant isolation

Architecture overview

Understand the layered architecture and design patterns

Development guide

Set up your development environment and start building
OrgStack is in active development. Star the GitHub repository to stay updated on new features and releases.

Build docs developers (and LLMs) love