🏥 Care.io - Professional Care Service Platform

A full-stack Next.js 15 platform connecting families with verified caregivers for children, elderly, and special-needs individuals.

🎯 Project Overview

Care.io is a comprehensive care service platform featuring:

3 User Roles: Client, Caregiver, Admin
Complete Booking Workflow: Browse → Book → Pay → Review
Real Payment Integration: Stripe Checkout with webhooks
Advanced Features: Notifications, Family Members, Address Book
Admin Panel: User & Booking Management
Modern Tech Stack: Next.js 15, TypeScript, TanStack Query, Redux, Supabase

✨ Key Features

For Clients:

🔍 Browse verified caregivers with advanced filters
📅 Book services with 4-step booking flow
💳 Secure payment via Stripe
👨‍👩‍👧‍👦 Manage family members
📍 Save multiple addresses
⭐ Leave reviews and ratings
🔔 Real-time notifications
📊 Track bookings and payments

For Caregivers:

💼 Manage assigned jobs
📆 View daily schedule
💰 Track earnings (85% payout)
⭐ View reviews and ratings
🔄 Update job status (Confirmed → Ongoing → Completed)
📱 Receive booking notifications

For Admins:

👥 User management (view, suspend, delete)
📋 Booking management (view, update status)
📊 Platform statistics and analytics
💵 Revenue tracking

🛠️ Tech Stack

Frontend:

Framework: Next.js 15 (App Router, Server Components)
Language: TypeScript (Strict Mode)
Styling: Tailwind CSS, DaisyUI
State Management:
- TanStack Query (Server State)
- Redux Toolkit (Client State)
Forms: React Hook Form + Zod
Animations: Framer Motion, AOS
UI Components: Custom + Material Icons

Backend:

Database: PostgreSQL (Supabase)
Authentication: NextAuth.js (Google OAuth + Credentials)
Payment: Stripe (Checkout + Webhooks)
Email: Resend + React Email
File Upload: Cloudinary
API: Next.js API Routes

Testing:

Framework: Jest
Library: React Testing Library

📁 Project Structure

care-xyz/
├── src/
│   ├── app/
│   │   ├── (auth)/              # Authentication pages
│   │   ├── (dashboard)/         # Dashboard pages (all roles)
│   │   ├── (protected)/         # Protected pages
│   │   ├── api/                 # API routes (25+ endpoints)
│   │   ├── caregivers/          # Public caregiver pages
│   │   ├── services/            # Public service pages
│   │   └── providers.tsx        # App providers
│   ├── components/              # Reusable components
│   ├── emails/                  # Email templates
│   ├── lib/                     # Utilities & configs
│   ├── store/                   # Redux store
│   ├── types/                   # TypeScript types
│   └── __tests__/               # Test files
├── supabase/
│   ├── schema.sql               # Database schema
│   └── seed.sql                 # Seed data
├── public/                      # Static assets
└── ...config files

🚀 Getting Started

Prerequisites:

Node.js 18+
npm or yarn
Supabase account
Stripe account (test mode)
Google OAuth credentials
Resend account (free tier)
Cloudinary account (free tier)

Quick Setup Guides:

📚 New to the project? Follow these guides in order:

QUICK_SETUP.md - Get Resend & Cloudinary keys in 5 minutes ⚡
SETUP_GUIDE.md - Detailed setup instructions with screenshots 📖
API_KEYS_CHECKLIST.md - Track your setup progress ✅

Installation:

Clone the repository

git clone <repository-url>
cd care-xyz

Install dependencies

npm install

Set up environment variables

Copy the example file and add your keys:

cp .env.example .env.local

Then follow QUICK_SETUP.md to get your Resend and Cloudinary API keys.

Your .env.local should include:

# Database (Supabase)
NEXT_PUBLIC_SUPABASE_URL=your_supabase_url
NEXT_PUBLIC_SUPABASE_ANON_KEY=your_anon_key
SUPABASE_SERVICE_ROLE_KEY=your_service_role_key

# NextAuth
NEXTAUTH_URL=http://localhost:3000
NEXTAUTH_SECRET=your_secret_key

# Google OAuth
GOOGLE_CLIENT_ID=your_google_client_id
GOOGLE_CLIENT_SECRET=your_google_client_secret

# Stripe
NEXT_PUBLIC_STRIPE_PUBLISHABLE_KEY=your_stripe_publishable_key
STRIPE_SECRET_KEY=your_stripe_secret_key
STRIPE_WEBHOOK_SECRET=your_webhook_secret

# Resend (Email) - Get from: https://resend.com/api-keys
RESEND_API_KEY=re_xxxxx

# Cloudinary - Get from: https://cloudinary.com/console
CLOUDINARY_CLOUD_NAME=your_cloud_name
CLOUDINARY_API_KEY=your_api_key
CLOUDINARY_API_SECRET=your_api_secret
NEXT_PUBLIC_CLOUDINARY_UPLOAD_PRESET=care-xyz-uploads

# App
NEXT_PUBLIC_APP_URL=http://localhost:3000

Verify your setup:

node test-api-keys.js

This will check if all your API keys are properly configured.

App

NEXT_PUBLIC_APP_URL=http://localhost:3000


4. **Set up database**

Go to Supabase Dashboard and run:

```sql
-- Run supabase/schema.sql
-- Run supabase/seed.sql

Run development server

npm run dev

Open browser

http://localhost:3000

🧪 Testing

# Run all tests
npm test

# Run tests in watch mode
npm run test:watch

# Run tests with coverage
npm run test:coverage

📊 Database Schema

10 tables with complete relationships:

users - User accounts
caregiver_profiles - Caregiver details
services - Available services
bookings - Service bookings
payments - Payment records
reviews - User reviews
addresses - Saved addresses
family_members - Family member records
promo_codes - Discount codes
notifications - User notifications

🔐 Authentication

Supported Methods:

Google OAuth (for clients)
Email/Password (for all roles)

User Roles:

CLIENT: Book services, manage family, leave reviews
CAREGIVER: Manage jobs, track earnings, update status
ADMIN: Manage users, bookings, platform settings

💳 Payment Flow

Client completes booking form
Redirected to Stripe Checkout
Payment processed securely
Webhook confirms payment
Booking created with CONFIRMED status
Email confirmation sent
Caregiver notified

Platform Fee: 15% (Caregiver receives 85%)

📧 Email Templates

Built with React Email:

Welcome Email (on registration)
Booking Confirmation (after payment)
Status Update (when caregiver updates)
Review Reminder (after completion)

🎨 UI/UX Features

Fully responsive design (mobile, tablet, desktop)
Dark mode ready
Smooth animations (Framer Motion, AOS)
Toast notifications
Loading states
Error handling
Empty states
Skeleton loaders

📱 Pages

Public:

Homepage
Services Listing
Service Detail
Caregivers Listing
Caregiver Profile
Login/Register

Client Dashboard:

Dashboard Overview
My Bookings
Payment History
Family Members
Address Book
Profile
Settings
Notifications

Caregiver Dashboard:

Dashboard Overview
Assigned Jobs
My Bookings
Schedule
Earnings
Reviews
Profile
Settings

Admin Dashboard:

Dashboard Overview
User Management
Booking Management
Settings

🔌 API Endpoints

Authentication:

POST /api/auth/register
POST /api/auth/[...nextauth]

Services:

GET /api/services
GET /api/services/[slug]

Caregivers:

GET /api/caregivers
GET /api/caregivers/[id]

Bookings:

GET /api/bookings/my-bookings
GET /api/bookings/assigned-jobs
POST /api/bookings/create
POST /api/bookings/create-checkout
POST /api/bookings/cancel
POST /api/bookings/update-status

Reviews:

GET /api/reviews
POST /api/reviews

Notifications:

GET /api/notifications
PUT /api/notifications
DELETE /api/notifications

Family & Addresses:

GET/POST/PUT/DELETE /api/family
GET/POST/PUT/DELETE /api/addresses

Admin:

GET/PUT/DELETE /api/admin/users
GET/PUT /api/admin/bookings

Webhooks:

POST /api/webhooks/stripe

🚀 Deployment

Vercel (Recommended):

Push code to GitHub
Import project in Vercel
Add environment variables
Deploy

Environment Variables:

Add all variables from .env.example to Vercel dashboard

Post-Deployment:

Configure Stripe webhook URL
Verify Resend domain
Test all features
Monitor errors

📈 Performance

Lighthouse Score: 90+
Server-side rendering
Image optimization ready
Code splitting
Lazy loading
Caching with TanStack Query

🔒 Security

Row Level Security (RLS) in Supabase
Protected API routes
Input validation (Zod)
Password hashing (bcryptjs)
CSRF protection
Role-based access control
Secure environment variables

🎯 Future Enhancements

📝 Demo Credentials

Client Account:

Email: client@example.com
Password: password123

Caregiver Account:

Email: caregiver@example.com
Password: password123

Admin Account:

Email: admin@example.com
Password: password123

🤝 Contributing

Contributions are welcome! Please follow these steps:

Fork the repository
Create a feature branch
Commit your changes
Push to the branch
Open a Pull Request

📄 License

This project is private and proprietary.

👨‍💻 Developer

Built with ❤️ using Next.js, TypeScript, and modern web technologies.

📞 Support

For support, email support@care.io

🙏 Acknowledgments

Next.js team for the amazing framework
Supabase for the backend infrastructure
Stripe for payment processing
Vercel for hosting
All open-source contributors

Status: Production Ready 🚀 Version: 1.0.0 Last Updated: February 2026

Name		Name	Last commit message	Last commit date
Latest commit History 38 Commits
public		public
src		src
.gitignore		.gitignore
README.md		README.md
eslint.config.mjs		eslint.config.mjs
next-auth.d.ts		next-auth.d.ts
next.config.ts		next.config.ts
package-lock.json		package-lock.json
package.json		package.json
postcss.config.mjs		postcss.config.mjs
tsconfig.json		tsconfig.json
vercel.json		vercel.json

Folders and files

Latest commit

History

Repository files navigation

🏥 Care.io - Professional Care Service Platform

🎯 Project Overview

✨ Key Features

For Clients:

For Caregivers:

For Admins:

🛠️ Tech Stack

Frontend:

Backend:

Testing:

📁 Project Structure

🚀 Getting Started

Prerequisites:

Quick Setup Guides:

Installation:

App

🧪 Testing

📊 Database Schema

🔐 Authentication

Supported Methods:

User Roles:

💳 Payment Flow

📧 Email Templates

🎨 UI/UX Features

📱 Pages

Public:

Client Dashboard:

Caregiver Dashboard:

Admin Dashboard:

🔌 API Endpoints

Authentication:

Services:

Caregivers:

Bookings:

Reviews:

Notifications:

Family & Addresses:

Admin:

Webhooks:

🚀 Deployment

Vercel (Recommended):

Environment Variables:

Post-Deployment:

📈 Performance

🔒 Security

🎯 Future Enhancements

📝 Demo Credentials

Client Account:

Caregiver Account:

Admin Account:

🤝 Contributing

📄 License

👨‍💻 Developer

📞 Support

🙏 Acknowledgments

About

Topics

Resources

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

Packages