LEADAGOTCHI

LEADAGOTCHI is a Tamagotchi-inspired micro CRM for freelancers who need a concrete daily view of their business without opening a large CRM, a Notion workspace, or a spreadsheet.

It behaves like a compact desktop utility. The monochrome business core reflects when real records need attention, while every gauge remains traceable to contacts, opportunities, invoices, and external progress.

Product Idea

The first screen answers one question: what needs attention today?

• Follow up with overdue leads.
• Revive stale opportunities.
• Review invoices approaching their due date.
• Add missing next steps.
• Keep a lightweight activity log.

The interface intentionally avoids decorative points, streaks, achievements, and opaque scoring.

Features

• Compact terminal console designed to run in a native macOS window through Tauri.
• Compact menu-driven navigation for contacts, deals, invoices, signals, logs, and settings.
• Minimal CRUD for contacts, opportunities, and invoices.
• Three ranked recommendations maximum.
• Five explainable maintenance indices: Momentum, Pipeline, Relations, Cash, and Clarity.
• A monochrome pixel-core identity portrait for the business state.
• Versioned local persistence with localStorage.
• Realistic demo data and a reset option.

Run Locally

npm install
npm run dev

Then open http://127.0.0.1:5173.

Run as a macOS desktop window:

npm run tauri:dev

Build the macOS app bundle:

npm run tauri:build

Run checks with:

npm run test
npm run build

How The Signals Work

Each index starts at 100 and loses points only for visible, explainable issues. Clicking a gauge opens its deductions and recommended action.

Signal	Concrete deductions
Momentum	Missing external business actions in the last seven days
Pipeline	No open opportunities or deals without progress for more than 21 days
Relations	Overdue follow-ups and active relationships that went cold
Cash	Unpaid invoices approaching or passing their due date
Clarity	Missing next steps, target dates, or useful deal notes

Notes and ordinary edits do not improve signals. Only real external progress counts.

Structure

src/
  components/       widget UI, setup, views and compact editors
  data/             realistic first-run demo records
  hooks/            application state and persistence mutations
  logic/            health indices, recommendations and core state
  types/            CRM domain types
  utils/            storage and date helpers

Screenshots

Add final screenshots here after deployment:

• Widget overview
• Explainable signal detail
• Compact contact editor
• Mobile layout

Future Improvements

• JSON and CSV import/export
• Calendar reminders
• Real notification system
• Daily business digest
• Keyboard command palette
• Custom business-core evolution
• GitHub Pages deployment
• Mobile compact mode