Raya-logs 🍼

A free, open-source baby tracker PWA built for sleep-deprived parents.
One-tap logging · Multi-caregiver sync · Works offline · Privacy-first

Features · Quick Start · Connect Your Database · Free vs Pro · Contributing · License

Why Raya-logs?

Most baby tracker apps are either too expensive, too cluttered, or don't let you own your data. Raya-logs is different:

🆓 100% free & open-source — host it yourself, own your data forever
📱 PWA — install on any phone, works like a native app, no app store needed
👨‍👩‍👧 Multi-caregiver — both parents (and grandparents!) track together with a shared family code
🔒 PIN-protected — 4-digit PIN keeps your data private
✈️ Offline-first — works without internet, syncs when back online
🎨 Beautiful UI — soft pastel theme designed for 3 AM use with one hand

Features

✅ Free (Open Source — this repo)

Feature	Description
🧷 Diaper Tracking	Log wet/dirty/both with color, consistency & quantity
🍼 Feeding Tracker	Timer or manual entry, left/right/both side tracking
😴 Sleep Sessions	Duration-based sleep logging with quality rating
🤱 Tummy Time	Timer or manual duration entry
💊 Vitamin D3	Simple given/not-given daily tracker
📝 Notes	Free-text notes for anything else
📏 Growth	Weight (kg) & height (cm) measurements
📊 Dashboard	Daily, weekly & monthly stats with charts
🔄 Real-time Sync	Changes appear instantly across all devices
📤 Export	Download daily summaries as HTML or full data as JSON
✏️ Edit History	Every edit is logged with who changed what and when
👶 Multi-baby	Track multiple babies under one family

💎 Pro (Paid — coming soon)

The Pro version is a hosted, managed service with additional features designed to make parenting even easier.

Feature	Description
🎙️ Voice Logging	"Hey Raya, log a wet diaper" — hands-free at 3 AM
🔔 Smart Reminders	Feeding reminders, vitamin alerts, milestone nudges
📋 Pediatrician Reports	One-tap export formatted for your baby's doctor
👨‍⚕️ Ask Doc	AI-powered answers to common newborn questions, sourced from AAP guidelines
💡 Daily Tips	Age-appropriate parenting tips delivered daily
📱 Push Notifications	Cross-device notifications for shared caregivers
🌙 Sleep Insights	Pattern analysis and sleep coaching suggestions
🏥 Consultant Support	Connect with certified pediatric consultants

Quick Start

Prerequisites

Node.js v18+ (download)
npm v9+ (comes with Node.js)
A Firebase project (free tier is more than enough — see Connect Your Database)

1. Clone the repo

git clone https://github.com/esainath96/raya-logs.git
cd raya-logs

2. Install dependencies

npm install

3. Set up environment variables

cp .env.example .env.local

Open .env.local and fill in your Firebase credentials (see next section for how to get them).

4. Start the dev server

npm run dev

Open http://localhost:5173 in your browser. That's it! 🎉

Connect Your Database

Raya-logs uses Firebase Firestore as its database. Firebase's free Spark plan gives you:

1 GiB storage
50K reads/day, 20K writes/day
More than enough for a family of caregivers

Step-by-step Firebase setup

📖 Click to expand full instructions

1. Create a Firebase project

Go to Firebase Console
Click "Create a project" (or "Add project")
Name your project (e.g., my-baby-tracker)
Disable Google Analytics if you don't need it (optional)
Click "Create project"

2. Create a web app

In your project dashboard, click the web icon </> to add a web app
Give it a nickname (e.g., baby-tracker-web)
Do NOT check "Firebase Hosting" (you're self-hosting)
Click "Register app"
You'll see a config object — copy those values:

const firebaseConfig = {
  apiKey: "AIza...",           // → VITE_FIREBASE_API_KEY
  authDomain: "xxx.firebaseapp.com",  // → VITE_FIREBASE_AUTH_DOMAIN
  projectId: "xxx",           // → VITE_FIREBASE_PROJECT_ID
  storageBucket: "xxx.appspot.com",   // → VITE_FIREBASE_STORAGE_BUCKET
  messagingSenderId: "123...",        // → VITE_FIREBASE_MESSAGING_SENDER_ID
  appId: "1:123...:web:abc..."        // → VITE_FIREBASE_APP_ID
};

Paste each value into your .env.local file

3. Enable Cloud Firestore

In the Firebase Console sidebar, click "Cloud Firestore"
Click "Create database"
Choose "Start in test mode" (you can lock it down later)
Select a location closest to you (e.g., us-central1, asia-south1)
Click "Enable"

4. (Recommended) Set Firestore Security Rules

Go to Firestore → Rules and replace the default rules with:

rules_version = '2';
service cloud.firestore {
  match /databases/{database}/documents {
    match /families/{familyId} {
      allow read, write: if true;  // Lock this down further in production
      
      match /logs/{logId} {
        allow read, write: if true;
      }
    }
  }
}

⚠️ For production use, implement proper authentication rules. The above is for getting started quickly.

5. Restart the dev server

npm run dev

The app will now connect to your own Firebase project!

🔄 Using an alternative database?

Raya-logs is architecturally simple — all database calls go through two hooks:

Hook	File	Purpose
`useFamily`	`src/hooks/useFamily.js`	Family CRUD, PIN verification
`useEntries`	`src/hooks/useEntries.js`	Log entry CRUD, real-time subscriptions

To swap Firebase for Supabase, PocketBase, Appwrite, or any other backend, you only need to rewrite these two files. The rest of the app doesn't know or care what database you use.

Project Structure

raya-logs/
├── public/                  # Static assets (favicon, icons)
├── src/
│   ├── assets/              # Images
│   ├── components/          # Reusable UI components
│   │   ├── ActivityFeed.jsx
│   │   ├── BottomSheet.jsx
│   │   ├── Charts.jsx
│   │   ├── ChipSelector.jsx
│   │   ├── DatePicker.jsx
│   │   ├── EditHistory.jsx
│   │   ├── EntryCard.jsx
│   │   ├── Layout.jsx
│   │   ├── PinInput.jsx
│   │   ├── QuickStats.jsx
│   │   └── Timer.jsx
│   ├── config/
│   │   └── firebase.js      # Firebase initialization (reads from env vars)
│   ├── context/
│   │   ├── AuthContext.jsx   # Authentication state
│   │   └── FamilyContext.jsx # Family data state
│   ├── hooks/
│   │   ├── useDashboard.js   # Dashboard data aggregation
│   │   ├── useEntries.js     # Firestore log entries CRUD
│   │   ├── useFamily.js      # Family management
│   │   └── useTimer.js       # Timer hook for feeding/tummy time
│   ├── pages/
│   │   ├── Dashboard.jsx     # Stats & charts
│   │   ├── Home.jsx          # Main logging screen
│   │   ├── Onboarding.jsx    # Family setup flow
│   │   ├── PinGate.jsx       # PIN unlock screen
│   │   └── Settings.jsx      # App settings
│   ├── sheets/               # Bottom sheet forms (one per entry type)
│   │   ├── DiaperSheet.jsx
│   │   ├── FeedingSheet.jsx
│   │   ├── GrowthSheet.jsx
│   │   ├── NoteSheet.jsx
│   │   ├── SleepSheet.jsx
│   │   ├── TummyTimeSheet.jsx
│   │   └── VitaminSheet.jsx
│   ├── utils/
│   │   ├── dateHelpers.js    # Date formatting utilities
│   │   ├── entryBuilders.js  # Canonical entry model (single source of truth)
│   │   ├── exportHelpers.js  # HTML/JSON export
│   │   ├── familyCode.js     # Family code generation
│   │   └── statsCalculator.js # Stats aggregation
│   ├── App.jsx               # Root component & routing
│   ├── index.css             # Complete design system
│   └── main.jsx              # App entry point
├── .env.example              # Template for environment variables
├── .gitignore
├── index.html
├── package.json
└── vite.config.js

Tech Stack

Layer	Technology
Framework	React 19 + Vite
Styling	Vanilla CSS with custom properties (design tokens)
Database	Firebase Firestore (swappable)
Offline	Firestore persistent local cache + multi-tab sync
Font	Nunito via Google Fonts
Package Manager	npm

Security Notes

Your data, your responsibility.

🔐 No API keys are stored in this repository. All credentials are loaded from environment variables.
🚫 The dist/ build folder is git-ignored. Production builds containing inlined env values never touch the repo.
🔑 .env.local is git-ignored. Your private credentials stay on your machine.
🧹 No telemetry, no analytics, no tracking. This app phones home to nobody except your own Firebase project.

If you fork this repo, always verify that your .gitignore includes *.local and dist before pushing.

Free vs Pro

	Free (Open Source)	Pro (Paid)
Price	$0 forever	Subscription (TBA)
Hosting	Self-hosted	Managed cloud
Core tracking	✅ All 7 entry types	✅ All 7 entry types
Multi-caregiver	✅	✅
Offline support	✅	✅
Dashboard & charts	✅	✅ + advanced insights
Data export	✅	✅ + formatted PDF reports
Voice logging	❌	✅
Smart reminders	❌	✅
Push notifications	❌	✅
Ask Doc (AI)	❌	✅
Daily parenting tips	❌	✅
Sleep insights	❌	✅
Consultant support	❌	✅

The free version is fully functional — you can track everything, sync across devices, and export your data. The Pro version adds convenience features for parents who want extra help at 3 AM.

Contributing

We welcome contributions! Please read our Contributing Guide before submitting a pull request.

Quick rules:

Fork the repo and create a feature branch
Follow the existing code style (vanilla CSS, functional React components)
Test your changes locally before submitting a PR
Don't commit .env.local or any credentials

License

This project is open-source under the MIT License.

Built with 💜 for sleep-deprived parents everywhere.
_{Created by Sainath}

Navigation Menu

Repository files navigation

Raya-logs 🍼

Why Raya-logs?

Features

✅ Free (Open Source — this repo)

💎 Pro (Paid — coming soon)

Quick Start

Prerequisites

1. Clone the repo

2. Install dependencies

3. Set up environment variables

4. Start the dev server

Connect Your Database

Step-by-step Firebase setup

1. Create a Firebase project

2. Create a web app

3. Enable Cloud Firestore

4. (Recommended) Set Firestore Security Rules

5. Restart the dev server

🔄 Using an alternative database?

Project Structure

Tech Stack

Security Notes

Free vs Pro

Contributing

License

About

Releases

Packages

Contributors

Languages

Name		Name	Last commit message	Last commit date
public		public
src		src
.env.example		.env.example
.gitignore		.gitignore
CONTRIBUTING.md		CONTRIBUTING.md
LICENSE		LICENSE
README.md		README.md
eslint.config.js		eslint.config.js
index.html		index.html
package-lock.json		package-lock.json
package.json		package.json
vite.config.js		vite.config.js

Latest commit

History

Folders and files

Repository files navigation

Raya-logs 🍼

Why Raya-logs?

Features

✅ Free (Open Source — this repo)

💎 Pro (Paid — coming soon)

Quick Start

Prerequisites

1. Clone the repo

2. Install dependencies

3. Set up environment variables

4. Start the dev server

Connect Your Database

Step-by-step Firebase setup

1. Create a Firebase project

2. Create a web app

3. Enable Cloud Firestore

4. (Recommended) Set Firestore Security Rules

5. Restart the dev server

🔄 Using an alternative database?

Project Structure

Tech Stack

Security Notes

Free vs Pro

Contributing

License

About

Topics

Resources

Contributing

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages