Skip to content

Quick Start Guide

Get up and running with Novaqy Care Connect in 5 minutes!

🚀 Fast Track Installation

# Clone and setup
git clone https://github.com/abhishekmendiratta/novaqy-care-connect.git
cd novaqy-care-connect
npm install

# Configure environment
cp .env.example .env.local
# Edit .env.local with your credentials

# Run development server
npm run dev

Visit http://localhost:3000 to see your app!

📋 Essential npm Scripts

Development

npm run dev          # Start development server
npm run build        # Build for production
npm run start        # Start production server

Database Operations

npm run supabase:link:us      # Link to US database
npm run supabase:link:india   # Link to India database
npm run supabase:migrate      # Apply migrations
npm run supabase:status       # Check migration status

Deployment

npm run cf:deploy:staging     # Deploy to staging
npm run cf:deploy:production  # Deploy to production

🗄️ Database Quick Setup

npm run supabase:link:india

2. Apply Migrations

npm run supabase:migrate

This creates: - ✅ 11 production tables - ✅ RLS security policies - ✅ 4 subscription plans - ✅ 20 geo landing pages

🎨 Key Features Overview

Customer Features

  • 🛒 Subscription checkout with Razorpay
  • 📍 Location-based landing pages (20 cities)
  • 💬 Live chat with Zoho SalesIQ
  • 📱 Responsive mobile-first design

Admin Features

  • 📊 Dashboard with analytics
  • 💰 Payment tracking
  • 🎫 Lead management
  • 📈 Revenue reporting

Developer Features

  • 🔐 Row-Level Security (RLS)
  • 🌍 Dual-region database (US + India)
  • 📝 Type-safe Supabase client
  • 🎯 Event tracking with n8n webhooks

🔑 Key Configurations

Supabase (Required)

  • Project URL and anon key for both regions
  • Service role keys for admin operations

Razorpay (Required)

  • Key ID and secret for payment processing
  • Webhook signature verification

Analytics (Optional)

  • Google Analytics 4 measurement ID
  • Google Ads conversion ID
  • Facebook Pixel ID

📚 Next Steps

  1. Configure Environment - Set up all integrations
  2. Database Schema - Understand data structure
  3. API Routes - Learn API endpoints
  4. Deployment Guide - Deploy to production

🐛 Common Issues

Issue: Port 3000 already in use

npx kill-port 3000
npm run dev

Issue: Database connection failed

  • Check .env.local has correct Supabase URLs
  • Verify API keys are not expired
  • Run npm run supabase:status to check connection

Issue: Build errors

rm -rf .next node_modules
npm install
npm run build

💡 Pro Tips

  1. Use dual-region setup - Configure both US and India databases for low latency
  2. Enable RLS policies - Always test with authenticated and anonymous users
  3. Monitor webhooks - Check n8n logs for payment/lead tracking
  4. Test locally first - Always run npm run build before deploying

🆘 Getting Help