semifold-core 0.1.1

Next-generation cross-language monorepo version and release management tool
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61

<div align="center">
  <picture>
    <source media="(prefers-color-scheme: dark)" srcset="./docs/public/logo-dark.svg">
    <source media="(prefers-color-scheme: light)" srcset="./docs/public/logo-light.svg">
    <img alt="Semifold Logo" src="./docs/public/logo-light.svg">
  </picture>

# Semifold

English | [δΈ­ζ–‡](README.CN.md)

</div>

Next-generation cross-language monorepo version and release management tool.

Nowadays, cross-language monorepos are becoming more and more common. For example, a monorepo may contain a Rust library and a Node.js package, developers use `napi-rs` to create Rust bindings for Node.js.

`semifold` (CLI: `smif` | `semifold`) helps teams manage versions, changelogs, and package publishing across large cross-language monorepos with **consistency, automation, and zero pain**. Whether you are building libraries, apps, or services across multiple languages, Semifold keeps your release pipeline clean and predictable.

## πŸ“– Documentation

For detailed usage instructions, please refer to the [official documentation](https://semifold.noctisynth.org).

## ✨ Features

| Feature                             | Description                                                    |
| ----------------------------------- | -------------------------------------------------------------- |
| **Cross-language monorepo support** | Manage versions for Rust / Node.js / more (extensible)         |
| **Changeset-based workflow**        | Clear and traceable version reasoning                          |
| **Automatic version bumping**       | `smif version` reads changes and bumps semver                  |
| **Automated changelogs**            | Generated from commit metadata / changesets                    |
| **One-command publishing**          | Publish multiple packages reliably                             |
| **CI-friendly design**              | `smif ci` gives a stable pipeline for GitHub Actions or others |

## πŸ“Œ Status

Languages supported:

- [x] Rust
- [x] Node.js
- [x] Python
- [x] C++
- [ ] Go
- [ ] Java
- [ ] Kotlin

## 🧠 Inspiration

Semifold was inspired by the great work from the following projects:

[Changesets](https://github.com/changesets/changesets) β€” a simple and elegant changeset-based versioning workflow, mainly focused on JavaScript and npm monorepos.

[Covector](https://github.com/jbolda/covector/) β€” a flexible multi-target release manager designed to support more complex ecosystems.

## 🀝 Contributing

Contributions are very welcome! Please read the [contributing guidelines](CONTRIBUTING.md) to get started.

## πŸ“„ License

Semifold is licensed under the AGPL-3.0 License.