---
title: Manifest reference
description: The inspected Omarchy 4 manifest schema supported by Forge.
---

# Manifest reference



Forge currently targets manifest schema 1 and the inspected Omarchy 4 contract.

```json
{
  "schemaVersion": 1,
  "id": "dev.example.project-pulse",
  "name": "Project Pulse",
  "version": "0.1.0",
  "kinds": ["bar-widget"],
  "entryPoints": {
    "barWidget": "Panel.qml"
  }
}
```

## Required fields [#required-fields]

`schemaVersion`, `id`, `name`, `version`, `kinds`, and `entryPoints` are
required. Third-party IDs must use safe characters, must not contain `..`, and
must not use the reserved `omarchy.*` namespace. Forge additionally requires a
semantic plugin version for publish readiness.

## Kind mappings [#kind-mappings]

| Kind         | Entry-point key |
| ------------ | --------------- |
| `bar`        | `bar`           |
| `bar-widget` | `barWidget`     |
| `menu`       | `menu`          |
| `overlay`    | `overlay`       |
| `panel`      | `panel`         |
| `service`    | `service`       |

Entry-point values must be nonempty safe relative paths to regular files. The
official validator rejects symlinks anywhere below the plugin root except
inside `.git`.

For bar widgets, optional `barWidget.defaultSection` accepts `left`, `center`,
or `right`. Settings defaults and schema entries live inside the `barWidget`
object and are persisted inline by Omarchy.

Always run both `omaforge check .` and `omarchy plugin validate .` before local
installation or publication.


---

For a semantic overview of all documentation, see [/sitemap.md](/sitemap.md)

For an index of all available documentation, see [/llms.txt](/llms.txt)