StellarCradle

StellarCradle is a comprehensive, celestial-themed companion for the journey of parenthood. Designed "for parents, not for spreadsheets," it blends practical health tracking with emotional storytelling, visual memory-keeping, and real-time partner collaboration. From the first kick to the first word, StellarCradle ensures every milestone is celebrated and every memory is shared.

Status: In active development (Production-ready PWA & Android Shell via Capacitor).

✨ What Makes it Special

• Collaborative by Design: Seamlessly link with a partner to share a unified dashboard. Every log, task, and memory is synchronized in real-time.
• The "Bling Pack": Delightful micro-interactions including heartbeat-pulsing fruit emojis, floating star particles, and celebratory confetti bursts for every milestone.
• Emotional Resonance: Beyond tracking, it offers features like Letters to Baby, a Gratitude Jar, and a Self-Care Garden to support parental well-being.
• Privacy First: Built with robust Supabase Row Level Security (RLS) to ensure family data remains private while enabling selective public sharing for the "village."

📱 Feature Ecosystem

🤝 Collaborative Tools

• Co-Parent Board: A dedicated Kanban board for managing family tasks, shopping lists, and hospital prep.
• Baby Name Voting: Collaborative "Tinder-style" or list-based voting system to find the perfect name with your partner.
• Partner Chat: Real-time communication with typing indicators and trimester-aware prompts.
• Rewards System: A gamified economy where partners can earn points to redeem for "nap passes" or special treats.

🤰 Pregnancy & Tracking

• Kick Counter: Interactive heart-beat tracker with daily summaries and weekly trends.
• Hospital Bag Checklist: Categorized packing lists with priority badges and live progress tracking.
• Birth Plan Builder: Comprehensive delivery preference manager with an exportable, decorated PDF for hospital staff.
• Growth Tracker: Interactive charts for weight, height, and head circumference.

📖 Visual Memories & Soul

• The Scrapbook: A customizable digital journal with multiple board backgrounds (cork, linen, pastel) and vintage photo frame styles.
• Bump Time-Lapse: A dedicated interface for weekly belly photos, auto-stitched into a horizontal progress strip.
• Letters to Baby: A rich-text journal for timestamped messages, categorized by mood and milestone.
• Milestone Journal: Documenting "firsts" with media support that auto-populates the scrapbook.

🧘 Wellness & Delight

• Self-Care Garden: A dynamic SVG flower that blooms petal-by-petal as you complete daily self-care goals.
• Breathing Bubble: A guided 4-7-8 breathing tool with a pulsing gradient orb for stress relief.
• Lullaby & Womb-Sounds: A floating audio player with ambient loops (heartbeat, white noise, rain).
• Bedtime Mode: A global UI toggle that dims the app to a dreamy, starry gradient for late-night use.

🛠️ Tech Stack

{
  "dependencies": {
    "react": "^18.3.1",
    "framer-motion": "^11.2.10",
    "zustand": "^4.5.2",
    "@supabase/supabase-js": "^2.43.4",
    "recharts": "^2.12.7",
    "capacitor": "^6.0.0",
    "lucide-react": "^0.395.0",
    "canvas-confetti": "^1.9.3",
    "tailwind-merge": "^2.3.0"
  }
}

Core Technologies:

• Frontend: React 18 with Vite and TypeScript for a type-safe, high-performance experience.
• State Management: Zustand with persistence middleware for offline-first capabilities.
• Backend: Supabase (PostgreSQL, Auth, Storage) leveraging Edge Functions for AI-powered monthly recaps.
• Animations: Framer Motion for smooth layout transitions and complex gesture support.
• Mobile Layer: Capacitor enabling a native Android experience with push notifications via Firebase Cloud Messaging (FCM).

⚙️ Technical Implementation

To achieve seamless collaboration between partners without data fragmentation, the backend utilizes PostgreSQL trigger functions. For example, the sync_partner_profile function automatically propagates changes to shared fields (like baby_name and due_date) between linked profiles, ensuring absolute data consistency.

-- Synchronizes critical profile data between linked partners
CREATE OR REPLACE FUNCTION public.sync_partner_profile()
 RETURNS trigger
 LANGUAGE plpgsql
 SECURITY DEFINER
AS $function$
BEGIN
  IF NEW.partner_id IS NOT NULL THEN
    UPDATE profiles
    SET baby_name = NEW.baby_name,
        due_date = NEW.due_date,
        due_date_start = NEW.due_date_start,
        onboarding_complete = true
    WHERE user_id = NEW.partner_id;
  END IF;
  RETURN NEW;
END;
$function$

The frontend aggressively handles data synchronization using a custom useCloudSync hook, which merges optimistic local updates with real-time Supabase channels, resolving potential conflicts silently in the background.

📸 Visual Walkthrough

Dynamic Dashboard

The central hub of the experience, featuring real-time tracking, time-aware greetings, and the "Bling Pack" animations.

Visual Scrapbook

A handmade journal aesthetic for preserving memories with customizable backgrounds and frames.

Baby Profile & Sharing

Centralized information for the baby with selective public sharing capabilities.