Contribute

Pargar is built in the open. Code, bug reports, AutoCAD-parity findings, translations and docs are all welcome.

Try it and report

Have a browser and ten minutes? Use cad.houshkar.ir and report what breaks: steps, expected vs. actual, browser. Open an issue →

Know AutoCAD?

Compare a command against AutoCAD and file a parity gap. Specs live in notes/specs/autocad-2d/.

Write Rust

Kernel work in packages/kernel: geometry, commands, DXF.

Write TypeScript / Svelte

UI, renderer and file I/O in packages/app, packages/renderer, packages/file-io.

Translate

This site is English and Persian; the app UI needs translating too. Write for a native reader, not word for word.

Start small

Look for good first issues and help wanted.

Pull requests

1. Open or find an issue first, and agree on the approach for anything non-trivial.
2. Branch from dev (the default branch). main only moves on releases.
3. Keep PRs focused, link the issue (Closes #N), and get CI green.
4. Every operation is a command: if a human can do it in the UI, an agent must be able to do it through the same command.
5. Never commit a secret. VITE_* values are public by design.
6. CI runs on GitHub-hosted runners only.

Read the seven rules first; every review holds changes to them.

Security

Found a vulnerability? Don’t open a public issue. Report it privately as described in SECURITY.md.

Licensing

Contributions are licensed under Apache-2.0 for code and CC BY 4.0 for documentation and translations. Everyone follows the Code of Conduct.

Read CONTRIBUTING.md