Seed Data Architecture

Overview

Gauzy seeds the database on first launch with essential reference data:

• Countries and currencies
• Languages
• Default roles and permissions
• Feature definitions
• Report categories
• Organization settings

Seed Types

Seed Configuration

Controlled via environment variables:

Seed Order

Seeds execute in dependency order:

Diagram source

graph TB
    A[Countries & Currencies] --> B[Languages]
    B --> C[Roles & Permissions]
    C --> D[Features]
    D --> E[Default Tenant]
    E --> F[Default Organization]
    F --> G[Super Admin User]
    G --> H[Report Categories]
    H --> I[Demo Data if enabled]

Creating Custom Seeds

export class MySeed implements ISeedModule {
  async createDefault(dataSource: DataSource): Promise<void> {
    // Seed default data
  }

  async createRandom(
    dataSource: DataSource,
    tenants: ITenant[],
  ): Promise<void> {
    // Seed random/demo data
  }
}

Related Pages

• Production Deployment — deployment guide
• Database Migration Guide — schema migrations