Desktop app

Titanbase ships as a free, open-source Electron desktop app (apps/desktop) for macOS, Windows, and Linux. It runs the same local-first visual editor you use in the browser, with native file handling and full offline support.

What it does#

• Native open, save, and Save As for .titan.json files through OS dialogs.
• Local PostgreSQL .sql import, schema compare, and migration-draft export.
• All schema export workflows (PostgreSQL, Mermaid, Prisma, Drizzle).
• Native application menus and keyboard shortcuts.
• Recent files, OS file-open events, and drag and drop of .titan.json and .sql files.
• Unsaved-change prompts for new, open, import, drag/drop, recent files, and close.
• File-changed-on-disk prompts that offer to reload or keep editing when an open .titan.json file changes externally.
• A larger default window and draggable title-bar regions.

Security model#

The desktop shell is locked down by default:

• Context isolation enabled.
• Renderer sandboxing enabled, Node integration disabled.
• A narrow, typed preload bridge is the only channel between the renderer and the system.
• A Content Security Policy and strict renderer navigation rules keep the bundled renderer from loading or navigating to remote content.

Install#

Packaging targets are configured with Electron Builder:

• macOS — dmg / zip
• Windows — nsis
• Linux — AppImage / deb

git clone https://github.com/titanbaserun/titanbase
cd titanbase
pnpm install
pnpm --filter titanbase-desktop build

Limitations#

• No signed/notarized installers or auto-update yet.
• Crash-safe local drafts are still on the roadmap.