LioRael

lenso: Build Bun-First TypeScript Plugin Applications

Lenso is a Bun-first TypeScript plugin framework for composing ordinary async services with explicit dependencies and resource cleanup. Optional Web, Auth, database, task, worker and agent-management adapters let teams add capabilities without coupling business code to them.

View on GitHub Compare
Stars
0
Forks
0
Stars, last 30 days
+0
Last commit
4 days ago
Contributors
2

Our take

Newless than six months old and changing fast

Health score

41/100

How it is scored
Activity
52
Community
13
Issues
21
Pull requests
77

+0 stars in the last 30 days

  • Merges more pull requests than 82% of the projects we track
  • Fewer contributors than 86% of the projects we track

Lenso offers a broad, carefully bounded toolkit for Bun-first TypeScript applications, but its very recent, fast-changing development and strong contributor concentration make it an early-adoption choice.

Good fit if

  • Your team builds TypeScript services for Bun and wants explicit plugin dependencies and resource cleanup.
  • You want to adopt optional framework adapters selectively rather than take on a single all-in-one runtime.
  • You can review a fast-moving project whose recent contributions come mostly from one maintainer.

Look elsewhere if

  • You need a mature framework with an established release cadence: the project is new and has no release in the past year.
  • You need built-in login routes, automatic HTTP or Manage mounts, or agent permissions without application-level configuration.
  • Your application needs a ready-made scaffold or deployment command. The repository describes templates as starting points, not scaffold or deployment tooling.
All health signals
Last commit2026-10-23 (4 days ago)
Commits, last 90 days100+
Releases, last 12 months0
Contributors2 (top contributor: 98% of commits)
Issues closed, last 90 days0
Pull requests merged, last 90 days72 (typically merged in 0 days)
Project age19 days

Checked on 2026-10-28 with the GitHub API.

Project history

Daily GitHub snapshots since Oct 7, 2026. History covers stars and forks; health signals are not tracked historically.

Selected snapshot

Stars

0

Forks

0

Change since Nov 16, 2026: 0 stars·0 forks

Overview

Lenso is a Bun-first TypeScript plugin framework built around Bun and ordinary async services. It helps application developers connect business code to explicit dependencies, manage resource lifetimes, and keep setup separate from the services themselves. Plugins can live in a TypeScript module, a workspace, or an npm package.

The core framework is separate from optional Engine, CLI, Web, Auth, database, task, Workers, MCP and Manage packages. This makes Lenso most relevant to teams building Bun applications that want an extensible service architecture, rather than a prebuilt application or a framework that automatically enables HTTP routes or grants agent access.

Key Features

  • Declares plugins and apps with typed dependencies bound to exact plugin instances.
  • Manages setup and cleanup, including rollback on setup failure and sequential LIFO shutdown.
  • Supports opt-in configuration contracts, multiple sources, validation and safe metadata inspection.
  • Provides a CLI for inspecting declared operations and invoking selected services.
  • Offers optional Web, Auth, Drizzle database, storage, durable task and Workers adapters.
  • Includes optional MCP and Manage integrations for explicitly selected operations, with authorization boundaries described in the package documentation.
  • Supports Engine extensions for build targets and development scheduling.

Use Cases

  • Bun application teams that want shared services to remain callable and testable outside framework setup.
  • Developers assembling applications from plugins with clear dependency and cleanup ownership.
  • Teams that need to expose selected services through a CLI or an explicitly configured Web interface.
  • Bun and Workers projects that want optional database, storage or task adapters while keeping platform-specific resources explicit.
  • Teams building agent integrations that need to select operations and provide their own identity verification and authorization.

What you need

Detected in the repository

  • Node.js (from package.json)
  • Automated checks on GitHub Actions

Getting Started

bun run prepare:runtime
bun install --frozen-lockfile
bun dev

See the repository README for the Bun Web quickstart, templates, package guides and configuration details.

License in Plain Words

No standard license was detected. Without a license, the default copyright rules apply: you may read the code, but not reuse it. Check the repository or ask the authors.

Considerations

Lenso is marked as new and has been changing rapidly, with more than 100 commits in the last 90 days. The project has two contributors, and nearly all measured contribution share is concentrated in one person. There have been no releases in the past year, and the measured issue data shows no issues closed in the last 90 days. These signals mean adopters should verify that published package versions include the APIs they need; the README itself warns that matching version strings do not prove feature availability.

The README documents Bun as the development path and pins a Bun version, while repository metadata lists Node.js as a runtime requirement. Confirm the requirements for the specific packages and consumer path you plan to use. The supplied repository data does not identify a license, so review the repository's current license terms before adoption. The project also leaves deployment, provider credentials, runtime-agent infrastructure and authorization policy to the application or host. Its PostgreSQL task provider and platform-specific database options require teams to choose and operate the appropriate infrastructure themselves.

Found this useful?

Share it with someone who would like lenso.