CodeSplinter

Smart Livestock Management for Rural India — role-based dashboards for farmers, panchayat/admin, and vets. Built with React + Vite + TypeScript + Supabase.

Features

• Role-based auth and routing: Farmer, Panchayat, Vet
• Farmer dashboard: animals list, vaccination due tracking, reminders, vet consultation requests
• Register animals with QR code generation and vaccination schedule
• Animal profile page for per-animal details

Tech stack

• Vite + React + TypeScript
• Tailwind CSS + shadcn/ui
• Supabase (Auth + Postgres)
• Vitest (tests)

Local setup

1) Prerequisites

• Node.js 18+ (recommended)
• npm

2) Install

npm install

3) Configure environment

Copy the template and fill in values:

cp .env.example .env

Required environment variables:

• VITE_SUPABASE_URL
• VITE_SUPABASE_PUBLISHABLE_KEY (this is your Supabase anon/publishable key)

4) Run

npm run dev

Open the printed local URL (usually http://localhost:5173).

Scripts

• npm run dev — start dev server
• npm run build — production build
• npm run preview — preview production build locally
• npm run lint — ESLint
• npm test — run tests (Vitest)

Database notes (Supabase)

This repo includes Supabase migrations under supabase/migrations/.

Typical workflow:

1. Create a Supabase project
2. Apply migrations using the Supabase CLI (optional for hackathon demos)
3. Ensure tables exist: profiles, animals, reminders, consultations

Deployment

You can deploy as a static SPA to Netlify/Vercel.

• Build command: npm run build
• Output directory: dist
• Add the same environment variables in your hosting provider settings.

License

Add a license if your hackathon requires one.