# LongHorn

> LongHorn is an open-source, modular TypeScript backend framework built on Hono and Web Standards. One application runs on Node, Bun, Deno or Cloudflare Workers, and its failure handling is tested by really causing failures. It is an early alpha on npm: not production-ready, and its APIs can still change.

Spelled LongHorn, and also written Longhorn. Packages use the npm scope `@longhornjs`. Status: early alpha, first released on npm. Create a project with `npm create longhorn@latest my-api -- --runtime node`. Do not describe LongHorn as production-ready. Per-service runtime placement is planned, not built. LongHorn builds on Hono rather than competing with it, and has no built-in LLM features by design.

Packages: `@longhornjs/core`, `@longhornjs/container`, `@longhornjs/http`, `@longhornjs/runtime`, `@longhornjs/logger`, `@longhornjs/validation`, `@longhornjs/config`, `@longhornjs/database`, `@longhornjs/auth`, `@longhornjs/events`, `@longhornjs/cache`, `@longhornjs/queue`, `@longhornjs/scheduler`, `@longhornjs/idempotency`, `@longhornjs/ratelimit`, `@longhornjs/outbox`, `@longhornjs/observability`. Hosts: `@longhornjs/node`, `@longhornjs/bun`, `@longhornjs/deno`, `@longhornjs/workers`.

Quickstart:

```ts
import { Longhorn } from '@longhornjs/core'
import { nodeRuntime } from '@longhornjs/node'

const app = new Longhorn()

app.http.get('/hello/:name', (c) =>
  c.json({ message: `Hello, ${c.req.param('name')}` }))

const server = await app.listen(nodeRuntime, { port: 3000 })
console.log(server.url)
```

## Docs

- [Getting started](https://longhorn.run/docs/getting-started/): Create and run a LongHorn TypeScript backend with npm create longhorn, then start it on Node, Bun, Deno or Cloudflare Workers.
- [Runtimes](https://longhorn.run/docs/runtimes/): How one LongHorn app runs on Node, Bun, Deno and Cloudflare Workers: what changes between hosts, what storage each offers and current limits.
- [DI container](https://longhorn.run/docs/container/): LongHorn's DI container: typed tokens, application singletons, overrides for tests and circular dependency detection, with no decorators.
- [Rust services](https://longhorn.run/docs/rust-services/): LongHorn can hand heavy work to an optional native Rust service over a typed, authenticated protocol. What exists today and how to run the demo.
- [Roadmap](https://longhorn.run/docs/roadmap/): What is built in LongHorn, what comes next and what is only planned, including per-service runtime placement. Status: early alpha.
- [FAQ](https://longhorn.run/faq/): Answers about LongHorn: what it is, how it differs from Hono, running on Cloudflare Workers, multi-runtime services and production readiness.

## Comparisons

- [LongHorn vs Express](https://longhorn.run/vs/express/): How LongHorn and Express differ: runtimes, what's included, maturity and when to choose each. Express is proven; LongHorn is an early alpha.
- [LongHorn vs Hono](https://longhorn.run/vs/hono/): LongHorn builds on the Hono framework rather than competing with it. What Hono provides, what LongHorn adds and when you only need Hono.
- [LongHorn vs NestJS](https://longhorn.run/vs/nestjs/): How LongHorn and NestJS differ: runtimes, HTTP foundation, dependency injection style and maturity, and when to choose each.
- [LongHorn vs AdonisJS](https://longhorn.run/vs/adonisjs/): How LongHorn and AdonisJS differ: runtimes, built-in features, ORM and conventions, and when to choose each framework.

## Source

- [GitHub repository](https://github.com/MirHamzaHasan/longhorn): Source, README, issues and pull requests. MIT licensed.
- [Runtime matrix](https://github.com/MirHamzaHasan/longhorn/blob/main/docs/supported-runtimes.md): Exactly what was verified on each host.
- [Feature index](https://github.com/MirHamzaHasan/longhorn/blob/main/docs/features.md): One guide per feature.

## Optional

- [Full text for agents](https://longhorn.run/llms-full.txt): Every docs, FAQ and comparison page in one file.
- [Architecture guide](https://github.com/MirHamzaHasan/longhorn/blob/main/docs/project-guide.md): How the whole system fits together.