Built for people who are tired of renting their business data back from the cloud.
One-liner: A desktop-first, local-first workspace for small and medium businesses β email, contacts, campaigns, tasks, calendar, automation, and security in one app, on your machine, under your control.
Why this exists: Small business owners shouldn't have to duct-tape six SaaS tools together to handle one customer conversation. Your machine, your business.
| Feature | What it actually does | |
|---|---|---|
| π§ | Multi-account inbox, Gmail API + IMAP/SMTP, labels, search, drafts, offline-safe actions | |
| π₯ | CRM | Contacts, groups, tags, dynamic segments, activity context, scoring |
| π£ | Campaigns | Campaign builder, mail merge, A/B, analytics, outreach workflows |
| π | Calendar | Calendar views and sync-oriented event management |
| β | Tasks | Priorities, due dates, recurrence, multiple views, linked workflow support |
| βοΈ | Automation | Trigger/action rules and automation builder flows |
| βοΈ | Composer | Signatures, attachments, aliases, undo-send, scheduled send |
| π | PGP | Sequoia OpenPGP integration for encrypted messages |
| ποΈ | Vault | Attachment vault and file workflows |
| π‘ | Deliverability | DNS, blacklist, bounce, and sender-health tooling |
| π€ | AI | Provider-based assistants for categorization, writing, summaries, inbox queries |
| ποΈ | Offline speech | On-device STT + TTS via sherpa-onnx β no API key, no network, audio never leaves the machine |
| π | i18n | English, French, Arabic, Japanese, Italian β including RTL for Arabic |
SMEMaster targets desktop (Windows Β· Linux Β· macOS) and Android, built with Tauri v2 + React 19 + Rust.
| State | Platforms |
|---|---|
| π§ In active development | Windows, Linux, macOS (desktop) Β· Android (mobile) |
| π¦ Buildable from source | Windows installer (NSIS) Β· Linux Β· macOS Β· Android APK/AAB |
| πΊοΈ On the roadmap | Signed store releases, broader multi-device sync, plugin ecosystem |
Builds are produced from source today; signed public installers are part of the v1.0 hardening pass (code signing certificates are the remaining blocker). Watch GitHub Releases.
Stage: v1.0.0-rc β feature-complete and compiling, pre-release hardening in progress.
Recently shipped
- ποΈ Offline speech (STT + TTS) β on-device via sherpa-onnx; STT RTF 0.033 at 99.8% match, TTS RTF 0.573, both verified end-to-end against the shipped binary
- βοΈ AI settings reorganized β Text Generation / Voice / Local Models, with a model catalog and resumable downloads
- π Sidecar lifecycle control β Start/Stop/Refresh in Settings β Voice, with honest engine-state reporting
- π Startup panic fixed β
EventBuswas read before it was managed, so the app could not start at all - π Sidecar Stop fixed β the watchdog restarted the process ~2 s after Stop, so the UI said "stopped" while it kept running
- ποΈ Reproducible sidecar build β
scripts/build-sidecar.shwired into every build; CI no longer ships a speech-less sidecar - π§° Tauri MCP bridge β dev-only; lets an agent drive the running app (this is what found the two bugs above)
- π¨ Settings UI overhaul β all 24 settings tabs beautified with premium card layout, stats rows, step-by-step setup wizards
- π RTL + i18n cleanup β 164 physical-direction CSS violations fixed across 48 files; 1,685
[TODO]translation prefixes cleared in fr/ar/ja/it locales - π Onboarding rework β standalone page after splash; auto-skips if email accounts or demo data already exist
- π€ AI RAG UI β local semantic search & RAG feature complete
- π·οΈ
account_idβcompany_idrename β 30+ files across the full stack, zero TS/Rust errors - π± Mobile UX Overhaul β all 5 phases 100% implemented
- ποΈ Data layer evolution β dead-code eliminated, offline-availability + optimistic email actions
- π’ Shared component library β 6 reusable UI primitives + 5 stability hooks/utils
- π’ Typed UI event bus (
uiBus) β replaced stringly-typedwindow.dispatchEvent("smemaster-*")with a fully-typed emitter
In progress
- Manual stability tests (panic injection, WAL recovery, watchdog restart)
- Code signing certificates + auto-updater pubkey
- 7-day dogfooding + public beta run
- Plugin architecture & store releases
Not yet verified β stated plainly rather than implied by a green check:
- TTS intelligibility β machine-checked as non-silent audio of the correct rate/duration; whether it sounds right is a human judgement
- Non-English STT β only English (Zipformer Small) is measured; other locales are model availability, not quality
- Live-call TTS β RTF 0.573 + STT 0.033 approaches real time; marginal for a live call
Full picture β docs/STATUS.md.
smeMaster/
βββ docs/ # Architecture, features, roadmap, release, user guides
β βββ 00-INDEX.md # Docs hub (start here)
β βββ 01-ARCHITECTURE/ # System & data-model design
β βββ 02-BACKEND/ # Rust & Tauri internals
β βββ 03-FRONTEND/ # React/TS patterns & guides
β βββ 04-FEATURES/ # Per-feature specs
β βββ 05-DEVELOPMENT/ # Contributor setup
β βββ 06-ROADMAP/ # Master plan
β βββ user-guide/ # End-user docs
βββ src/ # React 19 + TypeScript frontend
βββ src-tauri/ # Rust + Tauri backend/runtime
βββ scripts/ # Release & maintenance scripts
βββ package.json
Tech stack: React 19 + TypeScript 7 (UI) Β· Rust + Tauri v2 (native runtime) Β· SQLite + WAL (persistence) Β· Zustand (state) Β· sherpa-onnx (on-device speech) Β· typed IPC contracts Β· event-driven cache Β· built with bun and Vite 8 (Rolldown).
- Bun
1.4.2+β the package manager and script runner (lockfile isbun.lock; there is nopackage-lock.json) - Rust
1.77.2+ - Tauri v2 prerequisites
Windows note: make sure
C:\msys64\ucrt64\binis on yourPATH.
β οΈ Building with offline speech needs ~10 GB free. The sidecar links onnxruntime and lancedb; a full build plus the Tauri app can exceed 20 GB oftarget/.
git clone https://github.com/Zakarialabib/smeMaster.git
cd smeMaster
bun install
bun run tauri:dev| Command | Purpose |
|---|---|
bun run dev |
Start the Vite frontend only |
bun run test |
Unit tests (vitest --project unit, jsdom) |
bun run typecheck |
TypeScript 7 typecheck (tsc --noEmit) |
bun run lint |
ESLint, zero warnings tolerated |
bun run tauri:build |
Build the desktop app (builds the sidecar first) |
bun run windows:build |
Windows NSIS installer |
bun run android |
Android development flow |
bun run sidecar:build |
Build ml-sidecar with offline speech |
bun run tauri:dev:mcp |
Dev build with the Tauri MCP bridge (port 9223) |
bun, notnpm.npm installwill not honourbun.lock. If you need a one-off binary, usebunxinstead ofnpx.
The speech engine is an optional offline-speech feature of the ml-sidecar crate,
built and installed by scripts/build-sidecar.sh:
bun run sidecar:build:release # β src-tauri/binaries/ml-sidecar-<triple>.exetauri:build, windows:build and windows:portable all run this first, so the
bundled app can't ship without it.
--release. A debug build of this crate fails to link with
LNK1318: Unexpected PDB error β a PDB/filesystem limit on a ~234-object link,
not a code error.
offline-speech the sidecar compiles and runs but answers
unknown method to every speech call, which looks like a broken feature rather
than a wrong binary. See docs/02-BACKEND/20-offline-stt-and-audio-summarization.md.
Start at docs/00-INDEX.md. Key entry points:
| Area | Start here |
|---|---|
| Architecture | Overview Β· Backend structure Β· Data model |
| Backend | IMAP engine Β· SMTP Β· PGP Β· OAuth Β· Key management |
| Frontend | State Β· Service layer Β· Reuse patterns Β· Shared components |
| Features | Email Β· CRM Β· Campaigns Β· AI RAG Β· PGP |
| Development | Quickstart Β· Testing Β· Design system |
| Roadmap | Status Β· Master plan |
| User guide | Getting started Β· Account setup Β· PGP setup Β· Backup & restore |
| Changelog | Release Notes |
This is an indie, solo-founded project and contributions are genuinely welcome:
- Report bugs through Issues
- Propose ideas in Discussions
- Open PRs with tests where appropriate
- Improve docs when you spot drift or ambiguity
Preferred conventions: Conventional Commits, TypeScript strict mode, targeted tests for meaningful behavior changes.