Contributing

Molt combines a React frontend, a Tauri/Rust backend, and a bundled Python kernel server. A complete change often crosses more than one layer, so contributors should identify the owning boundary and run the corresponding quality gates.

Contributor path

1. Set up the development environment.
2. Review the repository architecture before changing a cross-layer contract.
3. Run the testing and quality matrix for the affected layers.
4. Use the release process when preparing distributable macOS artifacts.

Repository expectations

The source repository’s agent guidance requires a granular commit after each completed logical task. Keep changes focused and use descriptive messages. Do not combine unrelated frontend, backend, documentation, or release changes merely because they were developed together.

No separate public CONTRIBUTING.md or issue template defines an additional workflow in the documented release. Use a pull request against main so the macOS CI jobs can review Rust, Python, and frontend changes together.

Before opening a pull request

At minimum, run:

cd src-tauri
cargo clippy -- -D warnings
cargo test
cd ..
python3 -m pytest tests/python/ -v
npm run typecheck
npm run lint
npm run test

Run a Tauri development session for changes that affect window behavior, menus, process lifecycle, native effects, settings, or frontend/backend integration.