Ecosystem
Metacore is one platform spread across a small set of public repositories. This page is the map.
The big picture
┌──────────────────────────────────────┐
│ asteby/metacore │
│ ← you are here (the portal) │
└─────────────────┬────────────────────┘
│
┌───────────────────┴────────────────────┐
▼ ▼
┌───────────────────────┐ ┌───────────────────────┐
│ asteby/metacore- │ │ asteby/metacore- │
│ kernel │ │ sdk │
│ Go runtime │ │ TS packages + CLI │
│ • dynamic CRUD │◀────reads────│ • manifest schema │
│ • permissions │ │ • runtime-react │
│ • lifecycle │ │ • 16 npm packages │
│ • WASM sandbox │ │ • metacore-sdk CLI │
│ • WebSocket hub │ │ │
└──────────┬────────────┘ └────────────┬──────────┘
│ │
└────────────────┬───────────────────────┘
▼
┌──────────────────────────────────────┐
│ Hosts │
│ • your host application │
│ (operator panel, portal, admin, │
│ embedded settings, anything) │
└──────────────────────────────────────┘
▼
┌──────────────────────────────────────┐
│ Addons (.mcbundle) │
│ • first-party (built by you) │
│ • third-party (built by anyone) │
└──────────────────────────────────────┘Public repositories
| Repo | What it is | Docs |
|---|---|---|
asteby/metacore | This portal — the front door | you're on it |
asteby/metacore-kernel | The Go runtime | docs ↗ |
asteby/metacore-sdk | The npm packages and CLI | docs ↗ |
All three are Apache-2.0.
How they relate
- The portal explains the platform and routes to the other two.
- The kernel is the runtime. It's a Go library you embed; it owns persistence, REST, permissions, lifecycle, sandboxing, real-time.
- The SDK is the contract + the surface. It defines what an addon is (manifest schema, bundle format) and provides the React primitives that consume the kernel's metadata.
A working Metacore app is a host binary that imports the kernel, paired with a host frontend that imports the SDK, with one or more .mcbundle addons installed.
Hosts
Hosts are the products built on top of the kernel + SDK using only public APIs. The framework doesn't ship a host; you build one that fits your product. Common shapes include operator panels, marketplace + admin surfaces, customer-facing portals, embedded admin sections, and per-vertical UX layers.
See Hosts and Build a host for the recipe.
Versioning
The kernel and the SDK release independently. A host pins both. When a kernel feature requires a specific SDK version (or vice versa), it's noted in release notes; otherwise they evolve at their own pace.