A super-charged web framework for Bun, built on top of ElysiaJS.

Elysium.js is a full-stack, batteries-included framework that brings structure, scalability, and developer ergonomics to ElysiaJS. It provides an opinionated architecture with dependency injection, modular organization, background jobs, CLI tooling, observability, and more -- all running on the Bun runtime.

• Modular architecture -- Organize your application into self-contained modules with controllers, services, and repositories.
• Dependency injection -- Scoped, singleton, and transient service lifetimes with a built-in DI container.
• Multiple transport protocols -- HTTP, WebSocket, and WAMP controllers out of the box.
• Background job processing -- Redis-backed job queues with scheduling, retries, concurrency, and priority support.
• CLI code generators -- Scaffold controllers, services, models, jobs, middlewares, and entire modules from the command line.
• Built-in ORM integration -- First-class Drizzle ORM support with models, repositories, and migrations.
• Structured logging -- Multi-transport logger with decorators for automatic method-level logging.
• Observability -- OpenTelemetry tracing with decorator-based instrumentation and correlation IDs.
• Authorization -- Ability-based roles and permissions middleware.
• Build and deploy -- Compilation, bundling, Docker generation, and cross-platform binary building.
• Multi-tenant support -- Built-in tenancy module for multi-tenant applications.
• Caching and Redis -- Integrated caching layer and Redis client utilities.

Scaffold a new project with create-elysium:

bun create elysium my-app
cd my-app
bun install
bun run dev

The scaffolding CLI offers two project templates:

• Single-module -- A minimal starting point with one application module.
• Multi-module -- A structured layout with separate modules for different domains.

elysium/
  @elysiumjs/
    core/           # Core framework
    hermes/         # Logging
    heracles/       # Background jobs
    styx/           # CLI / code generators
    cerberus/       # Authorization
    hephaestus/     # Build system
    argus/          # Observability / tracing
    plugin-sentry/  # Sentry integration
  create-elysium/   # Project scaffolding CLI
  example/          # Example application

• Bun v1.3.9 or later
• Node.js (for Turborepo)
• Redis (required by @elysiumjs/heracles and caching features)

bun install

bun run build

bun run test

bun run test:coverage

bun run typecheck

bun run lint

This monorepo uses Changesets for versioning and Turborepo for build orchestration.

# Add a changeset
bun run changeset

# Apply version bumps
bun run version

# Build and publish
bun run release

Apache 2.0 -- Workbud Technologies Inc.