🦊 NextRush - Learning Project

import { createApp } from 'nextrush';

const app = createApp();

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

app.listen(3000);
// 🚀 Express.js-compatible API with zero dependencies

⚠️ Learning Project Notice

This is my first attempt at building a Node.js web framework. Created for educational purposes only.

🚨 For Production: Use Express.js, Fastify, or Koa instead.

🏆 Latest Benchmark Results (July 2025)

Ultimate Fox Test - Maximum RPS testing with Apache Bench on Intel i5-8300H, 14GB RAM

🥇 Overall Performance Rankings:

📊 Detailed Performance by Connection Count:

50 Connections (Light Load):

100 Connections (Medium Load):

200 Connections (High Load):

500+ Connections (Extreme Load):

🎯 Performance Analysis:

🚀 Fastify Strengths:

• Dominates low concurrency (50-200 connections)
• Excellent latency across all loads
• 9.5K RPS peak - industry-leading performance

💪 Express Strengths:

• Most consistent across all connection counts
• Handles high loads well (500+ connections)
• Proven stability under stress

🎓 NextRush Analysis:

• Best at 200 connections (architectural sweet spot)
• Competitive performance for a learning project
• Room for optimization - performance gap shows learning opportunities

� Key Performance Insights:

• NextRush achieves 61% of Fastify's peak performance - respectable for first framework
• Zero memory leaks detected across all test scenarios
• Performance gap mainly due to architecture complexity vs. mature optimization
• Learning-focused development prioritized features over raw speed
• Plugin architecture overhead impacts performance but provides flexibility

🔬 Test Configuration:

• Tool: Apache Bench (ab) for accurate RPS measurement
• Requests: 10,000 per test for statistical significance
• Duration: 60-second timeout per test
• Hardware: Intel i5-8300H, 14GB RAM, Ubuntu 25.04
• Node.js: v24.4.1 (latest LTS)
• Methodology: Multiple runs, averaged results

✨ What Makes NextRush Special

🔥 Built-in Features Comparison:

🔥 Core Features:

🛡️ Security & Validation:

• Input Validation - Built-in request validation with custom rules
• XSS Protection - Automatic cross-site scripting prevention
• SQL Injection Prevention - Query sanitization and parameterization
• CORS Management - Flexible cross-origin resource sharing
• Rate Limiting - Configurable request throttling per IP/user

📁 File Handling:

• Static File Serving - High-performance with compression & caching
• File Uploads - Multipart form data with size limits
• Download Management - Secure file downloads with access control
• Image Processing - Basic resize and format conversion

🌐 Real-time Features:

• WebSocket Support - Built-in WebSocket server with room management
• Server-Sent Events - Real-time data streaming to clients
• Long Polling - Fallback for real-time communication

📊 Monitoring & Debugging:

• Request Metrics - Built-in performance monitoring
• Health Checks - Automated endpoint health verification
• Error Tracking - Comprehensive error logging and reporting
• Memory Monitoring - Real-time memory usage tracking

🏗️ Architecture Highlights:

Plugin System:

// Load only what you need for maximum performance
const app = createApp({
  pluginMode: PluginMode.PERFORMANCE, // Only 4 essential plugins
  // vs
  pluginMode: PluginMode.FULL, // All 15+ plugins loaded
});

Memory Efficiency:

• Zero Dependencies - No bloated node_modules
• Smart Caching - Intelligent memory usage with TTL
• Buffer Pooling - Optimized memory allocation for high-traffic
• Garbage Collection - Minimal GC pressure design

🚀 Quick Start

Installation

# NPM (recommended)
npm install nextrush

# Yarn
yarn add nextrush

# PNPM
pnpm add nextrush

Basic Usage

import { createApp, PluginMode } from 'nextrush';

// Create app with full features (development)
const app = createApp();

// Or create app with performance mode (production)
const productionApp = createApp({
  pluginMode: PluginMode.PERFORMANCE, // 4 essential plugins only
  enableEvents: false,
  enableWebSocket: false,
});

// Express.js-compatible routes work unchanged
app.get('/api/users/:id', (req, res) => {
  const { id } = req.params;
  const { format } = req.query;

  res.json({
    id,
    name: 'John Doe',
    format: format || 'default',
  });
});

// POST with automatic body parsing
app.post('/api/users', (req, res) => {
  const userData = req.body; // Automatically parsed JSON
  res.status(201).json({ created: userData });
});

app.listen(3000, () => {
  console.log('🚀 NextRush server running on http://localhost:3000');
});

🔥 Advanced Features

File Uploads (Built-in)

// No multer needed - built-in file handling
app.post('/upload', (req, res) => {
  const file = req.file('document');
  const metadata = req.body;

  if (file) {
    res.json({
      uploaded: file.filename,
      size: file.size,
      metadata,
    });
  } else {
    res.status(400).json({ error: 'No file uploaded' });
  }
});

WebSocket Support (Built-in)

// No socket.io needed - built-in WebSocket
app.ws('/chat', (ws, req) => {
  console.log('New WebSocket connection');

  ws.on('message', (data) => {
    // Echo message to all connected clients
    app.broadcast('chat', `User: ${data}`);
  });

  ws.on('close', () => {
    console.log('WebSocket connection closed');
  });
});

Template Rendering (Built-in)

// No view engine setup needed
app.get('/profile/:username', (req, res) => {
  const data = {
    username: req.params.username,
    posts: ['Hello World', 'Learning NextRush'],
  };

  // Supports Mustache, Handlebars, EJS
  res.render('profile.mustache', data);
});

Authentication & Security (Built-in)

// Built-in JWT and session support
app.post('/login', async (req, res) => {
  const { username, password } = req.body;

  if (await validateUser(username, password)) {
    const token = req.signJWT({ username }, '24h');
    res.json({ token, message: 'Login successful' });
  } else {
    res.status(401).json({ error: 'Invalid credentials' });
  }
});

// Protected route with built-in middleware
app.get('/dashboard', req.requireAuth(), (req, res) => {
  res.json({
    message: `Welcome ${req.user.username}`,
    dashboard: 'data',
  });
});

🔄 Migrating from Express.js

Most Express.js code works unchanged with NextRush:

- const express = require('express');
- const bodyParser = require('body-parser');
- const cors = require('cors');
- const helmet = require('helmet');
- const multer = require('multer');

+ import { createApp } from 'nextrush';

- const app = express();
- app.use(bodyParser.json());
- app.use(cors());
- app.use(helmet());
- const upload = multer({ dest: 'uploads/' });

+ const app = createApp(); // All middleware built-in!

// All your existing routes work exactly the same
app.get('/api/users', (req, res) => {
  res.json({ users: [] });
});

- app.post('/upload', upload.single('file'), (req, res) => {
+ app.post('/upload', (req, res) => {
-   res.json({ file: req.file });
+   res.json({ file: req.file('file') }); // Built-in file handling
});

⚡ Performance Optimization

// For maximum performance (production)
const app = createApp({
  pluginMode: PluginMode.PERFORMANCE,
  enableEvents: false,
  enableWebSocket: false,
  enableMetrics: false,
  maxRequestSize: 1024 * 1024, // 1MB limit
  timeout: 30000, // 30 second timeout
});

// Results in ~20% better performance
// NextRush: 5,784 RPS → ~7,000 RPS (estimated)

📚 Learning Documentation

• 📖 Lessons Learned - My complete learning journey
• 📋 Project Status - Final achievements and metrics
• 🚪 Exit Plan - How to properly conclude a learning project
• 📊 Benchmarks - Complete performance testing suite

🎓 Educational Value

What I Learned:

• Framework architecture and design patterns
• Plugin systems and extensible architectures
• TypeScript advanced patterns and techniques
• Performance testing and optimization
• NPM package development and publishing

Key Insights:

• Architecture planning is more important than coding speed
• Simple solutions often outperform complex optimizations
• Plugin systems must be designed from day 1
• Testing should come before features, not after

🚀 Next Steps

This project achieved its educational goals. The knowledge gained will be applied to NextRush v2.0 - a complete rewrite with:

• ✅ Architecture-first approach
• ✅ Test-driven development
• ✅ Incremental feature addition
• ✅ Performance optimization from day 1

📄 License

MIT License - see LICENSE file for details.