CanxJS

Why CanxJS?

| Feature | Express | Laravel | CanxJS | | ----------------- | ------- | ------- | ------------ | | Requests/sec | ~15,000 | ~2,000 | 250,000+ | | Memory Usage | ~80MB | ~120MB | <30MB | | Startup Time | ~500ms | ~2000ms | <50ms | | Native TypeScript | ❌ | ❌ | ✅ | | Built-in ORM | ❌ | ✅ | ✅ |

Installation

# Create new project
bunx create-canx my-app
cd my-app
bun install
bun run dev

Or add to existing project:

bun add canxjs

Quick Start

import { createApp, logger, cors } from "canxjs";

const app = createApp({ port: 3000 });

app.use(logger());
app.use(cors());

app.get("/", (req, res) => res.json({ message: "Hello CanxJS!" }));

app.get("/users/:id", async (req, res) => {
  const user = await User.find(req.params.id);
  return res.json({ data: user });
});

app.listen();

Features

🚀 Ultra-Fast Routing

Radix Tree algorithm with O(k) route matching and JIT caching.

⚡ Async-First Design

Everything is async by default. No callback hell.

🔥 HotWire Protocol

Real-time streaming without WebSocket setup.

import { hotWire } from "canxjs";

app.get("/stream", (req, res) => hotWire.createStream(req, res));

// Broadcast to all clients
hotWire.broadcastHTML("updates", "<p>New data!</p>", "#content");

🧠 Auto-Cache Layer

Intelligent automatic caching with pattern analysis.

import { autoCacheMiddleware } from "canxjs";

app.use(autoCacheMiddleware({ defaultTtl: 300 }));

🗄️ Zero-Config ORM

MySQL primary, PostgreSQL secondary support.

import { Model, initDatabase } from "canxjs";

class User extends Model {
  static tableName = "users";
}

  .where("active", "=", true)
  .orderBy("created_at", "desc")
  .limit(10)
  .get();

// Eager Loading (N+1 Solution)
const users = await User.with('posts', 'profile').get();

🔐 Built-in Authentication & Sessions

Secure session management with Database, File, or Redis drivers.

import { auth, sessionAuth, DatabaseSessionDriver } from "canxjs";

// Use Database Driver for persistence
auth.sessions.use(new DatabaseSessionDriver());

app.post("/login", async (req, res) => {
  const session = await auth.sessions.create(user.id, { role: "admin" });
  return res.cookie("session_id", session.id).json({ status: "ok" });
});

app.get("/profile", sessionAuth, (req, res) => {
  return res.json({ user: req.context.get("user") });
});

🎨 Native JSX Views

import { jsx, renderPage } from "canxjs";

app.get("/about", (req, res) => {
  return res.html(renderPage(jsx("h1", null, "About Us"), { title: "About" }));
});

🎯 Controller Decorators

import { BaseController, Controller, Get, Post } from "canxjs";

@Controller("/users")
class UserController extends BaseController {
  @Get("/")
  async index() {
    return this.json(await User.all());
  }

  @Post("/")
  async store() {
    const data = await this.body();
    return this.json(await User.create(data), 201);
  }
}

CLI Commands

CanxJS includes a powerful CLI for project management:

# Project scaffolding
bunx create-canx my-app           # Create MVC project
bunx create-canx my-api --api     # Create API-only project
bunx create-canx my-svc --micro   # Create microservice

# Development (inside project)
bunx canx serve                     # Start dev server with hot reload
bunx canx build                     # Build for production
bunx canx routes                    # List all registered routes

# Generators
bunx canx make:controller User         # Generate controller
bunx canx make:model Post --migration  # Generate model with migration
bunx canx make:middleware Auth         # Generate middleware
bunx canx make:migration create_posts  # Generate migration
bunx canx make:seeder User             # Generate seeder
bunx canx make:service Payment         # Generate service

# Database
bunx canx db:migrate                   # Run migrations
bunx canx db:rollback                  # Rollback migrations
bunx canx db:seed                      # Run seeders
bunx canx db:fresh                     # Drop all & re-migrate

Project Structure

my-app/
├── src/
│   ├── controllers/
│   ├── models/
│   ├── views/
│   ├── routes/
│   ├── middlewares/
│   ├── config/
│   └── app.ts
├── public/
├── storage/
└── package.json

Documentation

• Getting Started
• Routing
• Controllers
• Models & ORM
• Middleware
• HotWire

License

MIT © CanxJS Team