Kin - Personal Relationship Manager, local-first and privacy-focused. Try at https://itchbox.tail018ac4.ts.net/game/kin
https://itchbox.tail018ac4.ts.net/game/kin
| .forgejo/workflows | ||
| .github/workflows | ||
| .gsd.bak_policy_test | ||
| .hermes | ||
| android | ||
| docs/voice-shortcuts | ||
| e2e | ||
| ios | ||
| public | ||
| scripts | ||
| src | ||
| .dockerignore | ||
| .gitignore | ||
| .gsd.bak_issue26_fail | ||
| .quickfix-prompt.txt | ||
| BUILD.md | ||
| capacitor.config.ts | ||
| components.json | ||
| docker-compose.yml | ||
| Dockerfile | ||
| eslint.config.js | ||
| gradlew | ||
| index.html | ||
| json | ||
| kimi_agent_kin_app_sync-CONTEXT.md | ||
| kin-app.apk | ||
| lefthook.yml | ||
| nginx.conf | ||
| package-lock.json | ||
| package.json | ||
| playwright.config.ts | ||
| postcss.config.js | ||
| README.md | ||
| RESEARCH-62.md | ||
| RESEARCH-66.md | ||
| tailwind.config.js | ||
| tsconfig.app.json | ||
| tsconfig.json | ||
| tsconfig.node.json | ||
| vite.config.js | ||
| vite.config.ts | ||
| vitest.config.ts | ||
Kimi_Agent_Kin App Sync
A local-first, privacy-focused Personal Relationship Manager (PRM) built as a Capacitor-wrapped React mobile app. Track relationships, interactions, important dates, and gifts — all data stays on-device via IndexedDB.
Tech Stack
- React 19 + TypeScript + Vite
- Tailwind CSS + shadcn/ui components
- Zustand for state management
- Dexie.js (IndexedDB) for local data persistence
- Capacitor for native Android/iOS wrapping
- Framer Motion for animations
Getting Started
git clone https://forgejo.tail018ac4.ts.net/Mark/kimi_agent_kin_app_sync.git
cd kimi_agent_kin_app_sync
npm install
npm run dev
Project Structure
src/
components/ # Shared UI components + shadcn/ui
pages/ # Screen components (Home, People, Dates, Settings, LogInteraction)
lib/
native/ # Capacitor native plugin wrappers
db.ts # IndexedDB (Dexie) data layer
store.ts # Zustand global state
types.ts # TypeScript interfaces
utils.ts # Helper functions
date-utils.ts # Date formatting & calculations
App.tsx # Router & layout
main.tsx # Entry point
public/ # Static assets (icons, manifest, service worker)
android/ # Android native project (Capacitor)
Scripts
| Command | Description |
|---|---|
npm run dev |
Start Vite dev server |
npm run build |
Production build (outputs to dist/) |
npm run lint |
Run ESLint |
npm run preview |
Preview production build |
Mobile Build
npm run build
npx cap sync android
npx cap open android
See BUILD.md for detailed Android/iOS build and signing instructions.
Features
- People directory with avatars, contact info, and relationship tags
- Interaction logging (calls, texts, in-person, email, etc.)
- Date/event tracking with reminders (birthdays, anniversaries)
- Gift ideas and tracking
- Contact frequency goals with overdue alerts
- Import/export all data as JSON
- Native mobile features: contacts import, camera, haptics, notifications, share
- PWA-capable with offline service worker