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 install

Run it

The browser loop suits most changes. It starts the host on port 8787 and the interface on port 3000.

pnpm dev:web

You 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 verify

A 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.