Open Source · MIT Licensed

KickJS

Modern type-safe backend framework, powered by Vite.

Built for developer experience, and pluggable as you need: database, jobs, real-time, AI and a typed client when you want them, down to the HTTP engine (Express, Fastify or h3). Types flow from your database to your frontend, and the dev server reloads as you save.

Get Started Why KickJS?GitHub

pnpm dlx @forinda/kickjs-cli new my-api

src/index.ts

import { bootstrap } from '@forinda/kickjs'
import { fastifyRuntime } from '@forinda/kickjs/fastify'
import { modules } from './modules'

export const app = await bootstrap({
  modules,
  runtime: fastifyRuntime(), // or h3Runtime(), or Express
})

🔌

Pluggable HTTP Runtimes

Run on Express, Fastify, or h3 — swap the engine in one line. Controllers, DI, and decorators never change.

Choose an engine

🎯

Decorator-Driven DI

@Controller, @Service, @Inject, @Cron, @Job — familiar patterns from Spring Boot and NestJS, with a zero-dependency DI container.

Explore decorators

🗄️

First-Class Database

kick/db — code-first schema, fully typed queries, and migrations for PostgreSQL, SQLite, and MySQL. No ORM lock-in.

Model your data

🧬

End-to-End Type Safety

Typegen makes Ctx resolve params, body, and query from your routes — caught at compile time, never drifting.

See typegen

📤

Uploads on Any Engine

@FileUpload → ctx.file / ctx.files with the same Multer shape on Express, Fastify, and h3. kick add upload wires the driver.

Handle files

📚

OpenAPI & Swagger

Generate an OpenAPI spec plus Swagger UI and ReDoc straight from your decorators — docs that stay in sync with code.

Document your API

🔁

Real-Time Built In

WebSockets, Socket.IO, and Server-Sent Events are first-class — rooms, heartbeats, and ctx.sse() out of the box.

Go real-time

⏱️

Jobs & Schedules

Background queues over BullMQ, RabbitMQ, or Kafka, plus @Cron scheduling — the same decorator ergonomics as your routes.

Run background work

✅

Validation, Your Way

Zod, Valibot, or Yup behind one KickSchema interface — env, request bodies, and OpenAPI all flow through it.

Validate inputs

⚡

Vite-Powered Dev

Zero-downtime hot reload via Vite. Database connections, Redis, and WebSocket state survive code changes.

Feel the HMR

🛠

CLI That Scaffolds Everything

kick new, kick g module (REST or minimal), kick add, kick doctor — scaffold an entire feature in seconds.

Use the CLI

🧩

Pluggable Everything

Auth, mail, caching, notifications, OpenTelemetry — every subsystem is an interface. You pick the implementation.

Build adapters