🇨🇳 中文 | 🇬🇧 English

The Local-First, AI-Augmented Workspace for Professionals.

sudo xattr -r -d com.apple.quarantine /Applications/Tada.app

Tada is a meticulously crafted task management solution that bridges the gap between traditional productivity tools and the era of Generative AI. Unlike cloud-centric alternatives, Tada is built on a Local-First philosophy. Whether you are using the web version or the native desktop application, your data remains strictly under your control.

Engineered as a modern Monorepo, Tada leverages React and Jotai for a fluid, reactive user experience, while Tauri provides a secure, performant native runtime. At its heart lies Moondown, a bespoke, WYSIWYG Markdown editor powered by CodeMirror 6, featuring AI-driven text continuation ("Ghost Writer") and slash commands.

Tada is designed for the privacy-conscious user.

• Zero Data Collection: No tracking, no analytics, no remote servers for data storage.
• Adaptive Persistence Layer:
  • Web: Utilizes LocalStorage and IndexedDB for instant, browser-based persistence.
  • Desktop: Leverages SQLite via Tauri for robust, file-system based storage capable of handling massive datasets.
• BYOK (Bring Your Own Key): AI features connect directly from your device to the provider (OpenAI, Anthropic, etc.). Your API keys never leave your machine.

Tada integrates Large Language Models (LLMs) deeply into the workflow, not just as a chatbot, but as a productivity engine.

• Natural Language Capture: Describe a complex project in plain English. Tada parses it into a structured task with a title, description, due date, priority, tags, and subtasks automatically.
• Ghost Writer: An AI co-pilot embedded within the task description editor. It understands the context of your task and suggests content, outlines, or next steps in real-time.
• Smart Summaries: Select any date range or list to generate comprehensive Markdown reports of your accomplishments, pending items, and future blockers.

A powerful, custom-built Markdown editing experience.

• Hybrid Editing: Writes like a document, saves as Markdown.
• Rich Features: Support for GFM (GitHub Flavored Markdown), tables, images (drag & drop), checklists, and code blocks with syntax highlighting.
• Slash Commands: Type / to instantly access formatting tools, insert tables, or trigger AI generation.

• Calendar View: A fully interactive drag-and-drop calendar for rescheduling tasks.
• Kanban & Lists: Flexible organization with custom lists and tags.
• Beautiful Theming: Native Dark/Light mode support with configurable accent colors (Coral, Ocean, Forest, etc.).
• Fluid Animations: Powered by framer-motion for a tactile, responsive feel.

Tada employs a robust Monorepo structure managed by pnpm workspaces, ensuring code sharing and strict separation of concerns.

graph TD
    Core["@tada/core (Business Logic & UI)"]
    Web["@tada/web (Browser Entry)"]
    Desktop["@tada/desktop (Tauri Entry)"]
    Storage["IStorageService Interface"]

    Web --> Core
    Desktop --> Core
    Core --> Storage
    Web -- Implements --> LocalStorageService
    Desktop -- Implements --> SqliteStorageService

• packages/core: The nucleus of the application. Contains reusable UI components (Radix UI + Tailwind), Jotai state atoms, React hooks, i18n locales, and the Moondown editor logic.
• packages/web: A lightweight wrapper that injects the LocalStorageService. Optimized for instant loading in browsers.
• packages/desktop: A Rust-backed wrapper using Tauri. Injects the SqliteStorageService for ACID-compliant database storage and system tray integration.

• Node.js: v18.0.0 or higher.
• pnpm: v9.0.0+ (Recommended package manager).
• Rust & Cargo: Required only for building the desktop application.

1. Clone the repository:

   git clone https://github.com/LoadShine/tada.git
   cd tada

2. Install dependencies:

   pnpm install

Web Environment: Run the standalone web application in your browser.

pnpm dev
# Application accessible at http://localhost:5173/tada/

Desktop Environment: Run the application in a native window using Tauri.

pnpm dev:desktop

To unlock Tada's full potential, configure an AI provider.

1. Navigate to Settings > AI Settings.
2. Cloud Providers: Select OpenAI, Anthropic, or Google. Enter your API key.
3. Local LLMs (Ollama):
   • Ensure Ollama is running (ollama serve).
   • Select Ollama as the provider.
   • Set Base URL to http://localhost:11434.
   • Model fetching is automatic.

Web Build: Generates a static site in packages/web/dist suitable for Netlify, Vercel, or GitHub Pages.

pnpm build

Desktop Build: Generates native binaries (.dmg, .exe, .deb) via Tauri.

pnpm build:desktop

We welcome contributions from the community. Whether it's a bug fix, a new feature for the Moondown editor, or a translation update, your input is valued.

1. Fork the project.
2. Create your feature branch (git checkout -b feature/AmazingFeature).
3. Commit your changes (git commit -m 'Add some AmazingFeature').
4. Push to the branch.
5. Open a Pull Request.

Distributed under the Apache 2.0 License. See LICENSE for more information.