OSS TanbouOn this page
Overview
Elysia is a TypeScript web framework designed primarily around Bun. It combines route definitions, runtime schema validation, and request/response type inference to keep server and client contracts aligned. Version 1.4.30 is a security-maintenance release for the 1.4 line while feature development moves to Elysia 2.
Features and best fit
Based on official documentation; not hands-on tested · Content checked:
Key features
Keep request and response contracts tied to TypeScript routes
Elysia combines TypeScript types with runtime schemas so route handlers, validation, and client integration can share a consistent contract.
Build compact HTTP services with Bun as the primary runtime
The README positions Elysia as Bun-powered, while the package also exposes Web Standard and Cloudflare Worker adapters alongside the Bun adapter.
Exercise handlers with Web Standard Request objects without listening on a socket
The package exposes adapter and handler paths that work with Web Standard requests, allowing local route validation without leaving a network listener running.
Sources: [2]
Best fit
Fits Bun and TypeScript backends that want type-centered API design
It is useful when schema validation, runtime behavior, server types, and client contracts should stay close together and API type drift should be minimized.
Sources: [1]
Before adoption
Treat 1.4.x as a security-only maintenance line
The 1.4.30 release explicitly states that 1.4.x will receive security updates only and no new features, making patch updates the priority for existing 1.4 applications.
Sources: [3]
Evaluate Elysia 2 as a separate migration line
Current feature development has moved to Elysia 2 / kiana beta. Production migrations should validate plugin and API compatibility and runtime requirements separately.
Sources: [3]
Align Bun and TypeScript versions with package peer requirements
The 1.4.30 package declares TypeScript 5+ and optional @types/bun 1.2+ peer requirements, so CI and local runtime versions should remain aligned.
Sources: [2]
Official sources
- [1]Elysia 1.4.30 README(2026-10-04)
- [2]Elysia 1.4.30 package metadata(2026-10-04)
- [3]Elysia 1.4.30 release(2026-10-04)
- [4]Elysia MIT license(2026-10-04)
Supplemental curator note
The 1.4.30 release states that the 1.4.x line will receive security updates only while feature development moves to Elysia 2. Keep existing 1.4 applications patched and evaluate 2.0 migration compatibility separately rather than mixing beta changes into production.
Try it in 3 steps
- 1
Add Elysia 1.4.30 to a Bun project
Pin stable 1.4.30, which is on security-maintenance status.
mkdir -p elysia-demo && cd elysia-demo && bun init -y && bun add elysia@1.4.30 - 2
Create a minimal route without opening a listener
Handle a Web Standard Request directly so route behavior can be checked without starting a server.
printf 'import { Elysia } from "elysia";\nconst app = new Elysia().get("/", () => "hello");\nconst res = await app.handle(new Request("http://localhost/"));\nconsole.log(await res.text());\n' > elysia-demo/index.ts - 3
Run the route check with Bun
Confirm that
hellois printed. Pin the Bun version and plugin set before production rollout.bun run elysia-demo/index.ts
Growth
Growth trends · Last 30 days
19,216 Stars
Trend data is still being collected.
Development activity
Last 90 days · weekly
- Commits (last 30 days)
- 0
- Open PRs
- 98
Development activity is still being collected.
Built with
Categories and tags
Categories
GitHub data
GitHub dataView detailed GitHub data
GitHub Topics
- framework
- typescript
- bun
- web
- http
- server
- Stars
- 19,216
- Forks
- 610
- Watchers
- 54
- Open issues
- 290
- Contributors
- 115
- Owner type
- Organization
- Primary language
- TypeScript
- License
- MIT
- Repository last updated
- Oct 2, 2026
Related information
Write a related articleShare a guide or use case for this OSS in Markdown. Articles are published after administrator approval.
Explore next
- FastAPI102,770 Stars
2 shared tag(s) · 2 shared category(s)
Unify validation, dependency injection, and OpenAPI around Python type declarations
Python - ASP.NET Core38,464 Stars
2 shared tag(s) · 2 shared category(s)
build web apps, HTTP APIs, and mobile backends on a modular cross-platform .NET web framework
C# - Actix Web24,852 Stars
2 shared tag(s) · 2 shared category(s)
build high-performance HTTP APIs and WebSocket services in Rust on the Tokio async ecosystem
Rust - Vue 2212,485 Stars
2 shared tag(s) · 1 shared category(s) · Same language
Maintain Vue 2 as an EOL legacy framework while planning Vue 3 migration and security or compliance handling
TypeScript - Firecrawl188,258 Stars
2 shared tag(s) · 1 shared category(s) · Same language
a web context API for search, scraping, crawling, and browser interaction
TypeScript - Angular101,014 Stars
2 shared tag(s) · 1 shared category(s) · Same language
Unify components, signals/DI, routing, forms, SSR/hydration, and CLI tooling in one TypeScript web application platform
TypeScript
Report incorrect information
Tell us if any listing information is incorrect or outdated.