🚀 INSITU - JS Framework

A fast, modular and extensible backend framework designed to build high-performance HTTP APIs and services with focus on real performance, full control and zero unnecessary dependencies.

Built for developers who prefer direct, predictable and efficient infrastructure, not heavy abstraction layers.

⚡ Principles

• Performance first — indexed routes, caches and O(1) structures
• Modular architecture — hooks, filters and decoupled modules
• Built-in observability — real-time administration
• Security by default
• No hidden magic — explicit and debuggable behavior

✨ Key Features

🧭 High-performance Routing

• Segment and prefix indexing
• Arity buckets
• Static and dynamic routes (regex)
• Route caching with hit/miss statistics

🧩 Modular System

• Hooks and filters
  • Hook system with support for actions and filters
  • Filters that allow modifying req, res, routes and file content
  • Configurable priorities for execution order
• External plugins without modifying the core
• Dynamic module loading
• Advanced hooks for route and static file handling
  • before_route_handler and after_route_handler for request manipulation
  • before_static_file_load and after_static_file_load for static file manipulation
  • Support for filters that allow modifying req, res and file content

🛠 Built-in Administration Console

Local TCP server for real-time inspection:

• active routes
• server statistics
• system status
• queues
• caches
• controller generation

📬 Queue System

• Multiple concurrent queues
• Priorities
• Automatic retries
• Fallbacks
• Pause / resume
• Manual cleanup and retries

📊 Observability

• Request/response metrics
• Most used endpoints
• View cache statistics
• System resource status
• Real-time monitoring

🔐 Security

• JWT authentication
• Roles and capabilities
• Security middleware
• Basic WAF
• Configurable cookie flags (Secure, SameSite, etc.)
• XSS / SQL Injection protection

🗄 Database

• Model system
• Integrated QueryBuilder
• MariaDB and SQLite support
• Migrations

🎨 Developer Experience

• Interactive controller generator
• Route manager
• Colored CLI
• Minimal configuration

🧠 Usage

The framework does not impose magic commands or proprietary wrappers.

It integrates directly into your binary/server, and administration is performed through:

• local TCP administration console
• CLI modules
• hooks and extensions

Check the project documentation for specific initialization examples based on your application.

🧱 Architecture

Request
   ↓
Router (indexed)
   ↓
Middleware / Hooks
   ↓
Controller
   ↓
View / JSON / Stream

Decoupled components → extensible → replaceable.

🔌 Extensibility

You can extend without modifying the core:

• administration modules
• custom hooks
• security filters
• middlewares
• external plugins

📈 Performance

Optimized for:

• fewer allocations
• less route normalization
• fewer linear searches
• more indexing and caching

Result: lower CPU, lower latency and higher throughput.

🗂 Versioning

We follow Semantic Versioning (SemVer).

Check detailed changes at: 👉 CHANGELOG.md

🤝 Philosophy

Less framework. More control. More performance.

Designed for teams that prefer to understand the complete system rather than depend on unnecessary abstractions.

📄 License

APACHE 2.0