open-mercato/open-mercato

What is it?

Key features

• 01Ready business modules for customers, catalog, sales, warehouse and customer portal
• 02Multi-tenancy with organization trees and feature-based RBAC
• 03Spec-first workflow with AGENTS.md and skills for Claude Code, Codex and Cursor
• 04Auto-generated REST APIs with OpenAPI docs
• 05Custom entities and fields managed from the admin, with field-level encryption

Use cases

• Building a B2B ordering portal or quoting system on a ready commerce backend
• Starting a CRM or ERP back office for a small business without building the basics
• Using the framework as a headless backend with a custom frontend
• Letting AI coding agents add features to a team codebase under shared architecture rules

Quick start

1. 1

   Scaffold a new app

   npx create-mercato-app my-app
2. 2

   Start PostgreSQL, Redis and Meilisearch

   docker compose up -d
3. 3

   Install dependencies

   yarn install
4. 4

   Migrate, seed demo data and start the dev runtime

   yarn setup

Things to know

• !Needs Node.js 24, Yarn via corepack and Docker installed.
• !On Windows it requires WSL2.
• !Enterprise modules are licensed separately from the MIT core.
• !Open Mercato Cloud is a Beta hosted trial.

In collections

Topics

FAQ

What is open-mercato?

A TypeScript framework on Next.js and PostgreSQL that ships ready CRM, ERP and commerce modules and rules for AI coding agents to build business apps. Open Mercato is an open-source TypeScript framework built on Next.js and PostgreSQL. A new app starts as a working back office with modules for customers, catalog, sales, warehouse, customer portal, workflows and more. Multi-tenancy, feature-based role permissions, domain events and field-level encryption are part of the core.

Is open-mercato free to use? What license does it have?

open-mercato is open source under the MIT license. Check the license terms before using it in commercial products.

Is open-mercato still maintained?

Actively maintained. The last commit to open-mercato was on Nov 7, 2026.

What can I use open-mercato for?

Building a B2B ordering portal or quoting system on a ready commerce backend Starting a CRM or ERP back office for a small business without building the basics Using the framework as a headless backend with a custom frontend Letting AI coding agents add features to a team codebase under shared architecture rules

How do I install open-mercato?

Scaffold a new app: npx create-mercato-app my-app Start PostgreSQL, Redis and Meilisearch: docker compose up -d Install dependencies: yarn install Migrate, seed demo data and start the dev runtime: yarn setup

Where can I get open-mercato?

The source code and installation instructions are on GitHub: https://github.com/open-mercato/open-mercato