v0.2.2 · Now Available
AxilJS

The JavaScript Backend
That Finally Rests.

AxilJS is a complete JavaScript backend ecosystem — HTTP, ORM, auth, AI, queues, observability, and cloud in one coherent platform. No assembling 40 packages from 40 different teams.

Copied to clipboard
17+
Packages
0
Config Files
9
Phases Shipped
100%
TypeScript
npm run dev

~ npx @axiljs/cli create my-api

Scaffolding AxilJS project...

Project structure

TypeScript config (strict mode)

All 17 packages installed

.env.example generated

~/my-api npm run dev

⚡ AxilJS v0.2.2 — development server

────────────────────────────────────

Server http://localhost:3000

Auth JWT · RBAC · scrypt

Security helmet · rate-limit · CSRF

ORM PostgreSQL · MySQL · SQLite

AI OpenAI · Anthropic · Gemini · Ollama

Memory leak detection active · GC optimized

Queue workers online · scheduler running

Watching src/ for changes... (incremental compilation)

~/my-api

Platform Overview

Six layers.
One ecosystem.

Each layer is independently useful but designed to compose into a complete production system — without glue code, without configuration fatigue, without dependency hell.

# One command

$ axil create my-api

$ cd my-api

$ axil run

Ready. Zero config.

17+
packages
0
config files
100%
TypeScript
01

Core Runtime

Trie-based HTTP router with O(log n) matching. Async middleware chain. Body parsing, static files, and Server-Sent Events streaming. Built-in SyntaxilitY Response Manager for consistent JSON responses across every endpoint.

HTTP/1.1RouterMiddlewareSSEResponse Manager
02

Security Layer

Production security headers via Helmet. Per-IP rate limiting with configurable windows (5 req/15 min on auth routes). CSRF protection. Input sanitization against XSS. Applied globally with one line.

HelmetRate LimitCSRFSanitizeXSS
03

Data & Auth

ORM with PostgreSQL (NeonDB/SSL), MySQL, and SQLite drivers. Fluent query builder. Automatic migrations with SERIAL/AUTOINCREMENT per driver. JWT with HMAC-SHA256. Password hashing via scrypt. Full RBAC middleware.

ORMJWTRBACMigrationsscrypt
04

Distributed Systems

Event bus with wildcard support. RFC 6455 WebSocket server with rooms and broadcast. Message queue with exponential backoff and cron scheduler. Circuit breaker with fallback. Prometheus metrics. W3C distributed tracing.

EventsWebSocketQueueMetricsTracing
05

AI Platform

Provider-agnostic LLM abstraction for OpenAI, Anthropic, Gemini, and Ollama (local, no API key). RAG pipeline with vector store and document indexing. AI agents with tool calling and max iteration control. MCP client.

LLMRAGAgentsMCPOllama
06

Cloud & Enterprise

Multi-tenant isolation middleware. Immutable audit logging. Feature flags with percentage rollout. Docker Dockerfile generation. Kubernetes deployment + HPA manifests. Memory leak detection with auto-fix and GC optimization.

Multi-tenantAuditK8sDockerMemory

Developer Experience

Ship a production API
in 20 lines.

Every import in this example comes from the same ecosystem. No third-party auth library. No separate validation package. No external security middleware. Full TypeScript inference from request to response.

  • JWT auth with role-based access control via @axiljs/auth
  • Security headers + rate limiting on every route
  • Schema validation with typed error responses
  • Full TypeScript strict-mode inference end-to-end
  • Hot reload with incremental TS compilation (npm run dev)
  • ORM with migrations — PostgreSQL, MySQL, SQLite

CLI

axil create my-apiScaffold new project
npm run devDev server + hot reload
axil buildCompile for production
axil testRun all test files
axil deployGenerate Docker + K8s
axil doctorDiagnose issues
Explore the full API reference
src/main.ts
1import { Application, cors } from '@axiljs/core'
2import { loadEnv, defineConfig } from '@axiljs/config'
3import { helmet, rateLimit } from '@axiljs/security'
4import { JWT, authenticate, requireRole } from '@axiljs/auth'
5import { v, validate } from '@axiljs/validation'
6
7// Typed env validation — fails fast on startup
8loadEnv()
9const config = defineConfig({
10  PORT:       { type: 'number', default: 3000 },
11  JWT_SECRET: { type: 'string', required: true }
12})
13
14// One application, zero configuration
15const app = new Application({ server: { port: config.PORT } })
16const jwt = new JWT(config.JWT_SECRET)
17
18// Security applied globally in three lines
19app.use(helmet())
20app.use(cors())
21app.use(rateLimit({ max: 100, windowMs: 60000 }))
22
23// Auth + validation composed per route
24app.post('/users',
25  authenticate(jwt),
26  requireRole('admin'),
27  validate({ body: v.object({
28    name:  v.string().min(2).max(100),
29    email: v.string().email(),
30    role:  v.enum(['admin', 'user']),
31  }) }),
32  async (req, res) =>
33    res.created(req.body, 'User created')
34)
35
36app.listen()

Built-in Response Manager

Consistent JSON.
Every time.

The SyntaxilitY API Response Manager is built directly into the res object. No imports needed. Every response is automatically formatted with status codes, typed messages, and pagination metadata.

res.success(data, msg)200 OK
res.created(data, msg)201 Created
res.paginated(...)200 + pagination
res.notFound(msg)404 Not Found
res.unauthorized(msg)401 Unauthorized
res.forbidden(msg)403 Forbidden
res.validationError(msg)422 Unprocessable
res.tooManyRequests()429 Rate Limited
res.paginated(users, 42, 1, 10)
{
  "status":  200,
  "code":    "HTTP_200_OK",
  "message": "Users fetched",
  "data": {
    "metadata": [ ... ],
    "pagination": {
      "total":       42,
      "page":        1,
      "limit":       10,
      "totalPages":  5,
      "hasNextPage": true,
      "hasPrevPage": false
    }
  }
}
res.validationError('Validation failed')
{
  "status":  422,
  "code":    "HTTP_422_UNPROCESSABLE_ENTITY",
  "message": "Validation failed",
  "errors": {
    "email": "Must be a valid email",
    "name":  "Minimum 2 characters"
  }
}

All Packages

18 packages.
One scope. Zero conflicts.

All under @axiljs — designed to compose, independently useful, no circular dependencies.

@axiljs/core

HTTP server, router, middleware, SSE, static files, response management

@axiljs/common

Shared utilities, types, HTTP abstractions, errors, and framework primitives

@axiljs/config

Environment loading, typed configuration, validation, and configuration management

@axiljs/security

Helmet headers, rate limiting, CSRF protection, and input sanitization

@axiljs/orm

Type-safe ORM with PostgreSQL, MySQL, SQLite, queries, entities, and migrations

@axiljs/auth

JWT authentication, password hashing with scrypt, authorization, and RBAC

@axiljs/validation

Schema-based request validation with typed schemas and structured validation errors

@axiljs/testing

Test runner, assertions, HTTP testing client, and application testing utilities

@axiljs/events

In-process event bus with pub/sub, wildcard events, and event-driven architecture

@axiljs/websocket

RFC 6455 WebSocket server with connections, rooms, broadcasting, and events

@axiljs/queue

Background jobs, message queues, cron scheduling, retries, and job processing

@axiljs/circuit

Circuit breaker, retry policies, timeouts, fallbacks, and fault tolerance

@axiljs/observability

Structured logging, Prometheus metrics, distributed tracing, and health checks

@axiljs/ai

LLM abstraction, RAG pipelines, AI agents, embeddings, vector stores, and MCP

@axiljs/cloud

Multi-tenancy, audit logs, feature flags, Docker, Kubernetes, and deployment tools

@axiljs/memory

Heap monitoring, memory leak detection, garbage collection analysis, and optimization

@axiljs/cli

Developer CLI for project creation, development, building, testing, and deployment

@axiljs/pm

AxilJS package manager for dependency management, workspace operations, and packages

Ecosystem Comparison

What you get
without assembling extra packages.

Ecosystem Comparison

Built-in capabilities across modern Node.js frameworks

CapabilityExpressFastifyNestJSHonoAxilJS
HTTP Server & Router
Middleware Pipeline
SSE Streaming
Static File Serving
Built-in Response Manager
ORM & Database Layer
Database Migrations
JWT Authentication
RBAC Authorization
Schema Validation
Security Middleware
Rate Limiting
CSRF Protection
Input Sanitization
Testing Toolkit
HTTP Test Client
Event Bus
WebSockets
Background Jobs & Queue
Scheduler / Cron
Circuit Breaker
Structured Logging
Prometheus Metrics
Distributed Tracing
Health Checks
AI / LLM Platform
RAG Pipeline
AI Agents
MCP Support
Multi-Tenancy
Audit Logs
Feature Flags
Memory Monitoring
Memory Leak Detection
GC / Heap Optimization
Docker / Kubernetes Support
CLI Tooling
Zero-Config Start
Modular Architecture
Enterprise Architecture
SupportedNot built-in
AxilJS Platform

Partial support counts as ✗. AxilJS ships every capability as a first-party package with consistent APIs.

Architecture Support

One ecosystem.
Every production architecture.

AxilJS is designed as a complete backend ecosystem rather than a single-purpose HTTP framework. Build monoliths, modular systems, distributed services, event-driven platforms, and AI-native applications using the same ecosystem.

MVC Architecture

A structured Model-View-Controller architecture for applications that benefit from explicit separation of responsibilities.

npx axil create blog --architecture mvc

Architecture

ModelsControllersRoutesMiddleware
JWT AuthenticationValidationORM

Monolithic Architecture

A complete application deployed as a single unit while retaining access to the full AxilJS ecosystem.

npx axil create shop --architecture monolith

Architecture

APIAuthORMQueue
PostgreSQLTransactionsRBAC

Modular Monolith

Organize a large application into isolated business modules without introducing distributed-system complexity.

npx axil create platform --architecture modular

Architecture

ModulesServicesRepositoriesEvents
Domain ModulesEvent BusShared Infrastructure

Microservices

Decompose applications into independently deployable services with communication, resilience, and observability built into the ecosystem.

npx axil create platform --architecture microservice

Architecture

ServicesWebSocketsEventsQueues
Circuit BreakerTracingHealth Checks

Event-Driven Architecture

Build asynchronous and reactive systems using the AxilJS event bus, queues, schedulers, retries, and background workers.

npx axil create worker --architecture event-driven

Architecture

Event BusQueueSchedulerWorkers
Pub/SubRetry & BackoffCircuit Breaker

AI-Native Architecture

Build AI-powered backend systems with LLM providers, RAG pipelines, agents, embeddings, vector stores, and MCP.

npx axil create ai-app --architecture ai

Architecture

LLMRAGAgentsMCP
StreamingVector SearchAI Providers

Same ecosystem. Different architecture.

Core, Security, ORM, Auth, Validation, Testing, Events, Queue, Observability, AI, Cloud, and Memory modules work across your application architecture.

AxilJS Ecosystem

Roadmap

The ecosystem is built.
The platform keeps expanding.

AxilJS is being developed as a complete backend ecosystem. Core runtime capabilities, security, ORM, authentication, testing, real-time systems, observability, AI, cloud, memory, and developer tooling are already part of the platform.

PHASE 01Core RuntimeShipped

HTTP server, routing, middleware, SSE streaming, static files, and the built-in response manager.

PHASE 02ConfigurationShipped

Environment loading, typed configuration, validation, defaults, and fail-fast startup configuration.

PHASE 03SecurityShipped

Helmet headers, rate limiting, CSRF protection, sanitization, and security middleware.

PHASE 04Database & ORMShipped

Type-safe ORM, entities, repositories, query building, transactions, and database migrations.

PHASE 05Authentication & ValidationShipped

JWT authentication, password hashing, RBAC authorization, schema validation, and typed validation errors.

PHASE 06TestingShipped

Test runner, assertions, HTTP test client, and application-level testing utilities.

PHASE 07Real-Time & EventsShipped

Event bus, pub/sub, WebSocket support, rooms, broadcasting, and event-driven communication.

PHASE 08Background ProcessingShipped

Queues, background jobs, schedulers, retries, timeouts, and resilient job processing.

PHASE 09Resilience & ObservabilityShipped

Circuit breakers, structured logging, metrics, tracing, health checks, and production diagnostics.

PHASE 10AI PlatformShipped

LLM providers, streaming, embeddings, RAG pipelines, AI agents, vector stores, and MCP.

PHASE 11Cloud & EnterpriseShipped

Multi-tenancy, audit logs, feature flags, containerized deployment, and Kubernetes-oriented infrastructure.

PHASE 12Memory & Runtime OptimizationShipped

Heap monitoring, memory leak detection, garbage collection analysis, and runtime optimization.

PHASE 13CLI & Developer ExperienceShipped

Project scaffolding, development workflow, builds, testing, package management, and deployment commands.

14
PHASE 14Distributed ArchitecturePlanned

Advanced microservice patterns, service communication, distributed events, resilience, and service-level observability.

13
Phases Shipped
1
In Development
14
Ecosystem Phases
Production-ready backend ecosystem

Build the backend.
Own the ecosystem.

AxilJS brings HTTP, ORM, authentication, validation, security, real-time communication, queues, observability, AI, cloud, memory management, and developer tooling into one modular TypeScript ecosystem.

axiljs

$ npm install @axiljs/core

+ @axiljs/core

+ AxilJS ecosystem ready

$ npx axil create my-api

$ cd my-api

$ npm run dev

AxilJS readyatlocalhost:3000

18 packages·TypeScript·Modular·Production-ready
HTTPORMAuthValidationSecurityWebSocketsQueuesObservabilityAICloudMemoryCLI