⚡ Express Spark

Spark your Express development - Zero boilerplate, maximum productivity

Express Spark is a powerful toolkit + CLI that supercharges Express.js development. Generate complete CRUD APIs in seconds, use intuitive helper functions, and build faster than ever.

🚀 Quick Start

# Install globally
npm install -g express-spark

# Generate a full CRUD API in seconds
express-spark create:server my-api --CRUD

# Run your new API
cd my-api && node my-api.server.js

That's it! You now have a running Express server with full CRUD endpoints.

✨ Features

• 🔥 Zero Configuration - Working API in 30 seconds
• ⚡ CRUD Generation - Complete REST APIs with one command
• 🛠 Helper Functions - Clean, reusable Express utilities
• 🎯 CLI Scaffolding - Smart project generation
• 🛡 Error Handling - Built-in async error management
• 📦 Middleware Support - Easy global and path-specific middleware

🎯 CLI Commands

Generate Basic Server

npx express-spark create:server my-app

Creates a simple Express server with example routes.

Generate CRUD API# Full CRUD server with all endpoints---

npx express-spark create:server my-api --CRUD

Creates a complete CRUD API with:

• GET /my-api - List all items

• POST /my-api - Create new item

• PUT /my-api/:id - Update item by ID

• DELETE /my-api/:id - Delete item by ID### Run Your Server### Installation

🛠 Helper Functions

Import and use powerful helper functions in your Express apps

Core Server Creation

import { createServer } from 'express-spark';

const app = createServer({
  port: 3000,
  middleware: [/* custom middleware */],
  onStart: (port) => console.log(`Server running on port ${port}`)
});

Route Helpers

import {
  createGetRoute,
  createPostRoute,
  createPutRoute,
  createDeleteRoute
} from 'express-spark';

// Simple route creation
createGetRoute({
  app,
  path: '/health',
  handler: (req, res) => res.json({ status: 'ok' })
});

Async Error Handling

import { asyncHandler } from 'express-spark';

createGetRoute({
  app,
  path: '/users',
  handler: asyncHandler(async (req, res) => {
    const users = await fetchUsers(); // Errors automatically caught
    res.json(users);
  })
});

CRUD Routes Made Simple

import { createServer, createCRUDRoute } from 'express-spark';

const app = createServer({ port: 3000 });
const products = [];

createCRUDRoute({
  app,
  basePath: '/products',
  handlers: {
    get: (req, res) => res.json(products),
    post: (req, res) => {
      const product = { id: Date.now(), ...req.body };
      products.push(product);
      res.status(201).json(product);
    },
    put: (req, res) => {
      // Update logic
    },
    delete: (req, res) => {
      // Delete logic
    }
  }
});

✅ Creates: GET /products, POST /products, PUT /products/:id, DELETE /products/:id

📋 Complete API Reference

| Function | Purpose | |----------|---------| | createServer() | Initialize Express app with middleware | | createGetRoute() | Create GET endpoint | | createPostRoute() | Create POST endpoint | | createPutRoute() | Create PUT endpoint | | createDeleteRoute() | Create DELETE endpoint | | createCRUDRoute() | Create full CRUD endpoints | | addMiddleware() | Add middleware globally or to paths | | asyncHandler() | Wrap async functions for error handling |

💡 Examples

Generate a blog API:

npx express-spark create:server blog --CRUD
# Creates: GET/POST/PUT/DELETE /blog endpoints

Generate a user service:

npx express-spark create:server users --CRUD
# Creates: Full user management API

Use helpers in existing project:

import { createGetRoute, asyncHandler } from 'express-spark';

createGetRoute({
  app,
  path: '/api/data',
  handler: asyncHandler(async (req, res) => {
    const data = await database.query('SELECT * FROM users');
    res.json(data);
  })
});

⚡ Why Express Spark?

• 🚀 10x Faster Development - Skip boilerplate, build features
• 📖 Consistent Patterns - Write cleaner, maintainable code
• 🛡 Production Ready - Built-in error handling and middleware
• 🎯 Zero Learning Curve - Familiar Express patterns
• 📦 Lightweight - No heavy dependencies
• 🔧 Flexible - Use CLI or helpers independently