The Architectural Paradigm

The Ultimate Headless ERP.

Pillar 1: Transparency

Complete Knowledge of the System

When you build on proprietary cloud ERPs, the backend is a black box. HeroBM provides complete structural clarity by shipping the code. From relational PostgreSQL schemas to immutable stock ledger calculations, every single rule is open for inspection.

Zero Black-Box Logic

Inspect the exact TypeScript code that executes quote-to-order conversions, 3-way invoice matching, inventory allocations, and double-entry GL ledger postings.

Direct SQL Database Power

No rate-limited REST bottlenecks for reporting. Query PostgreSQL directly with SQL, connect BI tools (Metabase, Superset), and run complex analytics in sub-milliseconds.

AI Agents with Total Context

Autonomous coding agents thrive on complete information. Because HeroBM exposes source code, DTOs, and schemas, agents generate integrations with zero hallucination.

Pillar 2: Extensibility

Predictable extensibility

HeroBM is designed to be easily extensible. Hook into our events, call APIs, swap out components, extend the data model and UI, and leverage your existing knowledge to build the ERP you need.

You can extend the system with confidence because we ship the test suite alongside the application source code. So you can ensure that your changes don't break anything in the core.

Multiple Extension Points

Extend the platform at any layer: TypeScript code, PostgreSQL database, REST endpoints, BullMQ message queues, or webhooks. There's a typed SDK to help.

Standard Open Patterns

No obscure proprietary 4GL languages. Built with widely-adopted standards: PostgreSQL, Next.js, Fastify/NestJS, and standard Docker containers.

AI-Friendly Architecture

Self-documenting APIs, strict TypeScript definitions, OpenAPI 3.0 specs, and an MCP server enable agents to move fast and safely.

import { ordersControllerFindAll } from '@herobm/sdk';

// 🚀 Fully typed, zero-boilerplate fetch calls!
const { data: orders } = await ordersControllerFindAll();

// Full IntelliSense: your IDE knows 'stateCode' exists
console.log(`Loaded ${orders.length} orders!`);
console.log(`Latest order status: ${orders[0].stateCode}`);

// Connect HeroBM directly to your AI Agents
export const checkOrderStatusTool = {
  description: 'AI Tool: Look up order status for the user',
  parameters: { orderNumber: 'string' },
  
  execute: async ({ orderNumber }) => {
    const { data } = await herobm.api.ordersControllerFindAll({ 
      orderNumber 
    });
    
    // The AI updates the user
    return { 
      status: data[0].stateCode, 
      notes: data[0].notes 
    };
  }
};

// 1. Initialise
const app = new HeroBM({ 
  apiKey: process.env.HEROBM_API_KEY,
  webhookSecret: process.env.HEROBM_WEBHOOK_SECRET 
});

// 2. Hook into standard extension points
app.events.on('sales_order.created', async (event) => {
  console.log(`Order created: ${event.entityId}`);
  console.log(`Order Number: ${event.payload.orderNumber}`);
});

// 3. Mount the automated webhook receiver middleware
const server = express();
server.use('/webhook', express.raw({ type: 'application/json' }), app.webhooks.expressMiddleware());
server.listen(3000, () => console.log('HeroBM Webhook Receiver started!'));

Unlimited Frontends

Any Head, Any Device, Any Workflow

When your ERP is truly headless and open-code, you are never locked into vendor-dictated user interfaces.

Custom B2B Portals

Build high-conversion customer ordering portals in Next.js, Remix, or Astro with real-time credit checks and custom pricing scales.

Mobile Warehouse Scanners

Deploy lightning-fast PWA or React Native scanner apps optimized for rugged Zebra/Honeywell barcode hardware on the warehouse floor.

Autonomous AI Operations

Empower LLM agents via Model Context Protocol (MCP) to monitor reorder points, draft purchase orders, and triage customer inquiries.

Direct Supply-Chain Sync

Link customer and vendor ERPs with sub-second Transactional Outbox relays, bypassing slow and expensive third-party iPaaS middleware.

Vision

Your Business, Unconstrained

True Digital Independence

Our goal is to equip small and medium-sized businesses with absolute ownership of their digital operations. We are building a world where you move faster, adapt immediately to market changes, and are never held hostage by a vendor's roadmap or escalating subscription tiers.

The End of Compromise

You should never have to alter your successful business processes to accommodate rigid software. The future belongs to businesses running on systems designed exactly for how they actually work.

The End of Lock-In

You have complete access to the code and the data. Bring your own tools and integrations. Leave when you want.

Local Support

We've built an industrial-grade, standardized foundation with ready-to-use workflows. You or your local IT partner can adapt it for your business. Software should be a tool that everyone can work with - not just Silicon Valley.