SuperBackend

Node.js middleware that gives your project backend superpowers. Handles authentication, billing, audit logs, file storage, error tracking, and more—all in one cohesive layer.

Features

• Authentication & Security: JWT-based auth with refresh tokens, organization management, and granular RBAC system
• Billing & Subscriptions: Full Stripe integration with checkout sessions, billing portal, and webhook processing
• File Storage: Unified S3/filesystem API with multipart uploads, namespace support, and public/private visibility
• Admin Panel: Basic-auth protected UI for user management, settings, metrics, and operational tasks
• Audit Logging: Append-only audit trail for security and compliance with admin search interface
• Error Tracking: Frontend + backend error aggregation with fingerprinting and admin triage UI
• Notifications: Multi-channel system with in-app notifications and email alerts
• Feature Flags: Dynamic feature toggles with rollout percentages and allow lists
• Global Settings: Runtime configuration with encrypted storage support for secrets
• Forms & Leads: Custom form definitions, lead capture, webhooks, and multi-tenant support
• Internationalization: JSON-based localization with server-side and client-side integration
• Organizations: Multi-tenant support with role-based member management
• Headless CMS: JSON configs, SEO configuration, and content management
• Email System: SMTP integration with templates and delivery tracking
• Webhooks: Outgoing webhook system for event-driven integrations
• Metrics & Activity: Usage tracking and analytics for business insights
• Middleware Mode: Drop-in Express middleware that preserves your app structure
• Workflows System: Node-based automation with LLM integration, conditionals, and HTTP calls
• LLM UI Integration: AI-powered UI components and conversational interfaces
• Admin Scripts & Terminals: Operational tooling for script execution and terminal management
• AI Agent System: Configurable AI agents with tool integration and multi-interface support
• CLI Tools: Terminal-based agent interaction and management commands
• Migration System: Database migration and data transfer between environments
• Upload Namespaces: Advanced file organization with customizable storage rules
• UI Components: Project-scoped reusable UI widgets with browser SDK integration
• UI Components AI Assistance: AI-powered generation and iteration of UI component code

Installation

npm install @intranefr/superbackend

or

yarn add @intranefr/superbackend

Quick Start

require('dotenv').config();
const express = require('express');
const { middleware } = require('@intranefr/superbackend');

const app = express();

// Mount under /saas prefix (recommended)
app.use('/saas', middleware({
  mongodbUri: process.env.MONGODB_URI,
  corsOrigin: process.env.CORS_ORIGIN || '*',
}));

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

Configuration

SuperBackend is fully configurable. Example options:

const backend = new SuperBackend({
  rbac: { /* roles, permissions */ },
  logging: { level: 'info', output: 'console' },
  metrics: true,
  queues: { redisUrl: 'redis://localhost:6379' },
  audit: true,
});

CLI Tools

SuperBackend includes command-line tools for AI agent interaction:

# List available agents
npx @intranefr/superbackend agent-list

# Start interactive chat with an agent
npx @intranefr/superbackend agent-chat

See CLI-README.md for detailed CLI usage.

Documentation

See the docs/features/ directory for detailed guides:

• Getting Started
• Core Configuration
• Admin API Usage
• Billing & Subscriptions
• Workflows System
• LLM UI Integration
• Migration System
• Upload Namespaces

Contributing

SuperBackend is open-source and welcomes contributions!
Please read the CONTRIBUTING.md for guidelines.

License

MIT © 2026 Intrane