Open Source · MIT Licensed

KickJS

The Adaptive Node.js Framework

Decorator-driven APIs that run on Express, Fastify, or h3 — swap the engine in one line. REST, WebSocket, queues, scheduled jobs. TypeScript-first, pluggable, production-ready.

Get Started Why KickJS?GitHub

npx @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 (minimal, REST, DDD, CQRS), 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