H
Harpia

Introduction

Harpia is a TypeScript framework built exclusively for the Bun runtime. It provides two layers of abstraction: a minimal Core for those who want full control, and an opinionated App structure for rapid development.

Bun Required

Harpia requires Bun v1.2 or later. Install it from bun.sh.

Why Harpia?

  • Bun-Native: Built from the ground up for Bun. No Node.js compatibility layer.
  • Two Layers: Start with the Core micro-framework or use the full App structure.
  • Type-Safe: Full TypeScript support with excellent inference.
  • Batteries Included: Auth, ORM, Mailer, Storage, and more in the App layer.

Quick Start

Install the core package to get started with a minimal setup:

bun add @harpiats/core

Or scaffold a full application with the App structure:

bun create harpia-app my-api

Pro Tip

If you’re new to Harpia, we recommend starting with the Core layer to understand the fundamentals before moving to the full App structure.

Core vs App

Core

Minimal, zero-dependency framework with Router, Middleware, and Shield.

    • Router & Middleware
    • Request/Response helpers
    • Shield security
    • CORS & Session

App

Full-featured framework with everything you need for production.

    • Everything in Core
    • Authentication
    • Prisma ORM
    • Mailer, Storage, Jobs

Next Steps

Ready to dive in? Head over to the Installation guide to set up your first Harpia project.