<div align="center">
  <img src="https://raw.githubusercontent.com/vercube/vercube/refs/heads/main/.github/assets/cover.png" width="100%" alt="Vercube - Unleash your server development." />
  <br>
  <br>

# @vercube/core

### Core framework for building HTTP APIs

[![Ask DeepWiki](<https://img.shields.io/badge/ask-deepwiki-%20blue?style=for-the-badge&logo=bookstack&logoColor=rgba(255%2C%20255%2C%20255%2C%200.6)&labelColor=%23000&color=%232f2f2f>)](https://deepwiki.com/vercube/vercube)
![NPM Version](<https://img.shields.io/npm/v/%40vercube%2Fcore?style=for-the-badge&logo=npm&logoColor=rgba(255%2C%20255%2C%20255%2C%200.6)&labelColor=%23000&color=%232e2e2e&link=https%3A%2F%2Fwww.npmjs.com%2Fpackage%2F%40vercube%2Fcore>)
![GitHub License](<https://img.shields.io/github/license/vercube/vercube?style=for-the-badge&logo=gitbook&logoColor=rgba(255%2C%20255%2C%20255%2C%200.6)&labelColor=%23000&color=%232f2f2f>)
![Codecov](<https://img.shields.io/codecov/c/github/vercube/vercube?style=for-the-badge&logo=vitest&logoColor=rgba(255%2C%20255%2C%20255%2C%200.6)&labelColor=%23000&color=%232f2f2f>)

**The heart of Vercube - everything you need to build fast, type-safe APIs with decorators, dependency injection, and validation.**

[Website](https://vercube.dev) • [Documentation](https://vercube.dev/docs/getting-started)

</div>

## ✨ Features

- **Declarative Routing** - define endpoints with `@Controller`, `@Get`, `@Post` and friends
- **Dependency Injection** - built-in IoC container, just `@Inject` what you need
- **Validation** - works with Zod, Valibot, ArkType out of the box
- **Middleware** - hook into request/response lifecycle
- **Runtime Agnostic** - runs on Node.js, Bun, and Deno

## 📦 Installation

```bash
pnpm add @vercube/core
```

## 📖 Usage

Check out the full [documentation](https://vercube.dev/docs/getting-started/installation)

## 📜 License

[MIT](https://github.com/vercube/vercube/blob/main/LICENSE)
