Skip to content

Home

Jump to bottom
Koneko edited this page Jul 28, 2026 · 6 revisions

🐾 Welcome to the Tamed Wiki

The Ultimate Gamified Routine Tracking, Behavioral Positive Reinforcement & Reward Management Ecosystem for Couples & Partners.

Live Web Application React Version Vite Version Supabase Deployment

Important

🌐 Official Live Web Application

Access Tamed directly in your browser: https://tamed.pages.dev/
No installation or setup required! Both partners can link accounts using a 6-digit pair code.

📚 Wiki Navigation Index

Category Pages & Resources Description
🚀 Getting Started User Onboarding Guide • Quick Start Step-by-step pairing and initial setup instructions.
👑 Owner Persona Owner Dashboard • Behavior Codex Managing routine tasks, approving rewards, and logging day status.
🦊 Pet Persona Pet Dashboard • Reward Store Checking off daily tasks, earning XP/points, and requesting rewards.
🔬 Architecture Tech Stack • Database Schema Technical overview of React 19, Zustand, Supabase RLS, and Cloudflare.

🌟 What is Tamed?

Tamed (formerly Puppy Schedule) is a mobile-first, real-time web application designed to transform routine tracking, accountability, and positive behavioral reinforcement into a fun, gamified experience for couples.

┌─────────────────────────────────────────────────────────────┐ │ 🌐 OFFICIAL WEB APP: https://tamed.pages.dev/ │ ├─────────────────────────────────────────────────────────────┤ │ 👑 OWNER DASHBOARD 🦊 PET DASHBOARD │ │ • Calendar Status (G/Y/R) • Interactive Mascot Avatar │ │ • Daily Behavior Codex • Level & XP Progress Bar │ │ • Reward Item Catalog • Custom Species Currency 🦴 │ │ • Instant Praise Sender • Store Redemptions & Requests│ │ • 6-Digit Pair Code Auth • Habit Checklists │ └──────────────────────────────┬──────────────────────────────┘ │ ┌───────────────────┴───────────────────┐ │ ⚡ HYBRID ENGINE (ZUSTAND) │ │ Realtime Supabase + Offline Demo │ └───────────────────────────────────────┘

👑 Dual-Persona Architecture

1. Owner Capabilities 👑

  • Behavior Codex Management: Create, customize, and edit daily routine tasks for your partner with custom XP rewards.
  • Calendar Status Logging: Log and monitor day quality using status indicators (🟢 Green / 🟡 Yellow / 🔴 Red).
  • Reward Approval & Fulfillment: Review pending reward requests submitted by your Pet, approve redemptions, or add custom store items.
  • Instant Praise & Head Pats: Send visual praise cards and quick instant nudges (e.g., "Drink Water 💧", "Time to Stretch 🐾").

2. Pet Capabilities 🦊

  • Daily Habit Tracking: Complete daily routines to gain +25 XP per task, level up, and build streaks.
  • Interactive Mascot Avatar: Customize species persona (Puppy 🐶, Kitty 🐱, Fox 🦊, or Custom ✨) with real-time level progress.
  • Species-Custom Currency System: Earn custom currency (Bones 🦴, Fish 🐟, Berries 🫐, or Stars ✨) based on green days and achievements.
  • Reward Store & Proposals: Spend earned points on custom rewards set by your Owner or propose new rewards.

🛠️ Technology Stack

  • Frontend: React 19, Vite 6, Vanilla CSS (Design Tokens, Glassmorphism, Responsive CSS Variables)
  • State Management: Zustand 5 (Hybrid store with automatic local offline fallback)
  • Backend & Realtime: Supabase PostgreSQL with Row-Level Security (RLS) & Realtime Channels
  • Icons & Audio: Lucide React, Web Audio API Sound Synthesizer
  • Hosting & CDN: Cloudflare Pages (tamed.pages.dev)

🚀 Quick Start

  1. Open tamed.pages.dev in your browser.
  2. Select your role (Owner or Pet).
  3. Copy your unique 6-digit Pairing Code and share it with your partner to link accounts.
  4. Start setting daily tasks, earning XP, and logging daily routines together!

For detailed setup instructions, database schemas, or contribution guidelines, check the repository README or open an issue.

Wiki Aided w/ AI cuz I can't be fkd

Clone this wiki locally