Product + code
Ship one complete, workspace-scoped improvement that works on device and preserves the shared platform architecture.
Open source, by design
Build FREE CRM
with us.
FREE CRM is a user-owned relationship operating system, free for everyone forever. Contribute code, documentation, tests, security improvements, or accessible design—without needing permission to care about the product.
Ways to contribute
Useful work comes
in many forms.
Quality + safety
Add regression coverage, tenant-isolation checks, failure recovery, or honest validation for a real production risk.
Docs + deployment
Make setup, self-hosting, recovery, and user-owned cloud credentials easier to understand and safer to operate.
Design + access
Improve clarity, responsive behavior, keyboard navigation, reduced motion, and assistive-technology support.
A clean contribution loop
Focused change.
Clear evidence.
- 01
Choose one focused problem.
Read the contribution guide and browse current work before starting. Keep the pull request small enough to review and complete enough to use.
- 02
Fork and branch from main.
Start from the latest upstream main branch. Never stack new work onto a branch whose earlier pull request has already merged.
- 03
Build the full slice.
Include implementation, tests, documentation, accessibility, and migration or security evidence whenever the change touches those boundaries.
- 04
Validate, sign, and submit.
Run the required checks, use a DCO sign-off, and explain behavior, risks, limitations, and verification in the pull request.
Start locally
Your machine.
Your fork.
Use Node.js 22.13 or newer and npm. Replace the account placeholder with your GitHub username, then work from the latest upstream main.
git clone https://github.com/<your-account>/FreeCRM.git
cd FreeCRM
git remote add upstream https://github.com/mlmrx/FreeCRM.git
git fetch upstream main
git switch -c ml/short-description upstream/main
npm ci
npm run devReady when you are