https://github.com/trifrost-js/core
A blazing-fast, runtime-agnostic server framework built for the modern JavaScript ecosystem — from low-latency edge environments to traditional backend infrastructure
https://github.com/trifrost-js/core
bun cloudflare cloudflare-workers nodejs npm otel router server-framework typescript
Last synced: 4 months ago
JSON representation
A blazing-fast, runtime-agnostic server framework built for the modern JavaScript ecosystem — from low-latency edge environments to traditional backend infrastructure
- Host: GitHub
- URL: https://github.com/trifrost-js/core
- Owner: trifrost-js
- License: mit
- Created: 2025-05-06T18:54:48.000Z (5 months ago)
- Default Branch: main
- Last Pushed: 2025-06-12T21:34:17.000Z (4 months ago)
- Last Synced: 2025-06-12T22:52:50.089Z (4 months ago)
- Topics: bun, cloudflare, cloudflare-workers, nodejs, npm, otel, router, server-framework, typescript
- Language: TypeScript
- Homepage: https://trifrost.dev
- Size: 1.08 MB
- Stars: 17
- Watchers: 2
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE.md
Awesome Lists containing this project
README
# TriFrost
[](LICENSE)
[](https://codecov.io/gh/trifrost-js/core)
[](https://github.com/trifrost-js/core/actions/workflows/ci.yml)
[](https://github.com/trifrost-js/core/actions/workflows/github-code-scanning/codeql)
[](https://www.npmjs.com/package/@trifrost/core)
[](https://www.npmjs.com/package/@trifrost/core)
**TriFrost** is a blazing-fast, runtime-agnostic server framework built for the modern JavaScript ecosystem — from low-latency edge environments to traditional backend infrastructure.
Whether you're deploying to Node.js, Bun, Cloudflare Workers, or uWebSockets.js, TriFrost provides a unified API and internal architecture that adapts to the runtime — without compromising on performance, developer experience, or clarity.
---
## ✨ Why TriFrost?
TriFrost is the result of deep experience across frameworks, runtimes, and production systems. It combines:
- 🧩 **Koa-like composability**: build with middleware that’s small, explicit, and powerful
- ⚡ **uWS-level performance**: thanks to tight internal control over routing, context, and async flows
- 🌐 **Edge-native philosophy**: designed from the ground up to support Cloudflare Workers, and other emerging runtimes
- 🧠 **Observability-first design**: tracing is not an afterthought; it’s a core design concern with built-in support for structured telemetry
Unlike many frameworks, TriFrost doesn't bind itself to Node-specific APIs or assume a single deployment model. It’s truly runtime-flexible, letting you write code once and run it almost anywhere.
---
## 📦 Installation
Using your favorite package manager:
```bash
# bun
bun add @trifrost/core
# npm
npm install @trifrost/core
# pnpm
pnpm add @trifrost/core
# yarn
yarn add @trifrost/core
```
---
## 🧠 Core Principles
TriFrost is guided by a few key beliefs:
- **No magic. Ever.** You should be able to trace exactly how data flows and how handlers resolve.
- **Lean by default.** We ship zero dependencies that aren’t critical to the core behavior.
- **Typed end-to-end.** First-class TypeScript support with generics and inference deeply embedded.
- **Adaptable internals.** Routing, context, and state management are designed to be both composable and overridable.
---
## 🚀 Project Status
TriFrost is under active development as we build toward a solid `v1.0` milestone.
The internal architecture is already production-grade, but APIs may still evolve as we polish developer ergonomics, refine edge-case behaviors, and finalize DX across runtimes.
If you're early-adopting:
- We recommend pinning patch versions
- Feedback and PRs are very welcome
- Expect aggressive iteration
---
## 🔗 Resources
- 🧑💻 GitHub: [trifrost-js/core](https://github.com/trifrost-js/core)
- 📦 npm: [`@trifrost/core`](https://www.npmjs.com/package/@trifrost/core)
- 🌐 Website: [trifrost.dev](https://trifrost.dev)
- 💬 Discord: [Join the community](https://discord.gg/e9zTXmtBG8)
---
## 🤝 Contributing
Contributions are very welcome!
If you're looking to get involved:
- 📄 Check the [open issues](https://github.com/trifrost-js/core/issues) or [discussion threads](https://github.com/trifrost-js/core/discussions)
- 🧪 Run tests with `npm run test` or check coverage with `npm run test:coverage`
- 🔧 Code is written in modern TypeScript — **type safety and performance matter**
Whether it's a bug fix, new module, test case, or doc improvement — PRs are appreciated and reviewed quickly.
---
## 👤 Author
Created and maintained by [Peter Vermeulen](https://github.com/peterver)