Local-first, privacy-focused research and personal note-taking desktop and web app.
Getting Pulm Notes running locally takes only two steps:
git clone https://github.com/Luxion-Labs/PulmNotes.git
cd PulmNotes
bun install && bun run devFor native desktop build:
bun run tauri:dev- Node.js 18+ (or bun 1.0+)
- bun package manager
- For desktop app: Rust toolchain (see Tauri prerequisites)
-
Install dependencies using bun:
bun install
-
Web App: Start the development server:
bun run dev
Open http://localhost:3000 in your browser
-
Desktop App: Run the Tauri development build:
bun run tauri:dev
Web App:
bun run build
bun startDesktop App:
bun run tauri:buildInstallers will be created in src-tauri/target/release/bundle/
- Framework: Next.js 15 (App Router)
- Desktop Shell: Tauri 2.0 (Rust)
- UI Library: React 19
- Styling: Tailwind CSS
- Icons: lucide-react
- Package Manager: bun
- Local-first: All data stays on your device
- Offline-capable: Works without internet
- Private: No cloud, no tracking, no accounts
- Minimalist text editor interface
- Slash command menu (type
/to open) - Support for multiple block types (headings, lists, code, quotes, etc.)
- Keyboard shortcuts for navigation and editing
- Clean, responsive design
- Desktop app: Native performance with Tauri
- Next.js Migration: See
docs/NEXT_MIGRATION_LOG.md - Tauri Integration: See
TAURI_AUDIT_LOG.mdfor desktop architecture details
- Ensure commits follow Conventional Commits.
- When ready to release, run:
git tag vX.Y.Z
git push origin vX.Y.Z- GitHub Actions will run CI, semantic-release, generate
CHANGELOG, updatepackage.jsonversion, create the GitHub Release, attach Tauri artifacts, and generate checksums.
Luxion Labs enforces a strict 24-hour response SLA on all community issues, feature proposals, and pull requests. See CONTRIBUTING.md for full development guidelines.
Distributed under the MIT License. See LICENSE for details.