Build itwith us.
Para is MIT licensed and built in the open.
Find your way
One repository holds the daemon, the interface, the Mac shell and the browser host.
- apps/daemon
- Gmail sync, the store and the API
- apps/desktop/web
- The interface, shared by both apps
- apps/desktop/src-tauri
- The Mac shell, in Rust
- apps/server
- The host for the browser version
- packages/contracts
- Types shared by all of them
- apps/landing
- This site
A storage change goes in as the next numbered migration. A shipped migration is never edited.
Set up
You need Node.js 22, pnpm 10 and Bun 1.3. For the Mac app you also need macOS, the Xcode Command Line Tools and Rust.
pnpm installRun it
The browser loop suits most changes. It starts the host on port 8787 and the interface on port 3000.
pnpm dev:webYou do not need a Gmail account to work on the interface. The fixture preview runs on sample data.
Prove it green
One command runs the type checks, the linter and every test suite. It must pass before a pull request.
pnpm run verifyA change in behaviour comes with a test that fails without it.
House rules
Keep a change small and about one problem. Fix the cause, not the symptom.
Write interface text in short, plain sentences. Keep secrets out of the repository.
Test data uses invented people, never real mail.
Open a pull request
Branch from main and name the branch after the change, for example fix/draft-threading. Say what changed and why in each commit message.
For interface work, look at the result in light and dark themes and attach both screenshots.
Security problems
Do not open a public issue for a security problem. Follow SECURITY.md in the repository and report it privately.
The repository address will be listed here when it is public.