# Documentation

Learn how Semifold versions and publishes packages across every ecosystem in one repository.

Source: https://semifold.noctisynth.org/docs/
Language: en



Semifold is a versioning and release tool for monorepos that span multiple languages and package ecosystems. It connects packages that use different manifests and registries, then manages their changesets, related version updates, changelogs, and dependency-ordered publishing as one repository-wide workflow.

## Choose what you need [#choose-what-you-need]

<Cards>
  <Card title="Install Semifold" href="/docs/getting-started/installation/">
    Install the published CLI with the script, Cargo, npm, or PyPI.
  </Card>

  <Card title="Make your first release" href="/docs/getting-started/first-release/">
    Initialize a repository, create a changeset, review affected packages, and run version and publish.
  </Card>

  <Card title="Understand Semifold" href="/docs/introduction/">
    See how package manifests, stable package IDs, dependencies, changesets, and release commands fit together.
  </Card>

  <Card title="Configure a repository" href="/docs/configuration/overview/">
    Learn the structure and maintenance workflow of `.changes/config.toml`.
  </Card>

  <Card title="Extend an ecosystem" href="/docs/plugins/overview/">
    Use the published JavaScript plugin runtime and TypeScript SDK for custom package formats.
  </Card>

  <Card title="Look up a term" href="/docs/concepts/glossary/">
    Distinguish packages, PackageId values, ecosystems, changesets, channels, registries, and plans.
  </Card>
</Cards>

## The repository-wide lifecycle [#the-repository-wide-lifecycle]

<LifecycleDiagram
  items="[
  'Packages in different ecosystems',
  'One dependency-aware workspace',
  'Changesets describing user-visible changes',
  'Related version and changelog updates',
  &#x22;Publish with each ecosystem's rules&#x22;,
]"
/>

The ecosystem adapter for each package understands its manifest. Semifold owns the relationships across adapters: stable package identity, cross-ecosystem dependency propagation, changeset intent, release channels, changelogs, publish ordering, and recovery reporting.

## A useful reading order [#a-useful-reading-order]

If Semifold is new to you, read [the introduction](https://semifold.noctisynth.org/docs/introduction/) before the configuration reference. Then complete [the first-release tutorial](https://semifold.noctisynth.org/docs/getting-started/first-release/) with a small repository. Use the [glossary](https://semifold.noctisynth.org/docs/concepts/glossary/) whenever an unfamiliar domain term appears.

The [command documentation](https://semifold.noctisynth.org/docs/commands/) explains each command in detail. Its [CLI reference](https://semifold.noctisynth.org/docs/commands/reference/) is a lookup page, not the primary way to learn the workflow.