Hearty Foundation Platform

A comprehensive volunteer management and healthcare support platform built with React, TypeScript, Vite, and Supabase.

Features

• Volunteer Registration & Management
• Care Facility & NGO Registration
• Business Partner Integration
• Urgent Needs Tracking
• Event Management
• User Dashboard & Profile
• Authentication & Authorization
• Real-time Updates with Supabase

Tech Stack

• Frontend: React 18, TypeScript, Vite
• Styling: Tailwind CSS
• Database: Supabase (PostgreSQL)
• Authentication: Supabase Auth
• Icons: Lucide React
• Deployment: Azure Web App

Getting Started

Prerequisites

• Node.js 18 or higher
• npm or yarn
• Supabase account

Installation

1. Clone the repository:

   git clone https://github.com/YOUR_USERNAME/hearthy-foundation.git
   cd hearthy-foundation

2. Install dependencies:

   npm install

3. Create a .env file in the root directory:

   VITE_SUPABASE_URL=your_supabase_url
   VITE_SUPABASE_ANON_KEY=your_supabase_anon_key

4. Run the development server:

   npm run dev

5. Open http://localhost:5173 in your browser

Build for Production

npm run build

The built files will be in the dist/ directory.

Deployment

This project is configured for automatic deployment to Azure Web App via GitHub Actions.

See GITHUB_AZURE_DEPLOYMENT.md for detailed deployment instructions.

Quick Deployment Steps:

1. Create an Azure Web App
2. Download the publish profile
3. Add GitHub secrets
4. Push to main branch

The GitHub Actions workflow will automatically build and deploy your app.

Project Structure

hearthy-foundation/
├── src/
│   ├── components/        # React components
│   ├── contexts/          # React contexts (Auth)
│   ├── lib/              # Utilities and configs
│   ├── types/            # TypeScript types
│   ├── App.tsx           # Main app component
│   └── main.tsx          # Entry point
├── supabase/
│   └── migrations/       # Database migrations
├── public/               # Static assets
├── .github/
│   └── workflows/        # GitHub Actions workflows
└── dist/                 # Production build (generated)

Database

The project uses Supabase for database and authentication. Database schema includes:

• User Profiles
• Volunteers
• Care Facilities
• Foundations/NGOs
• Business Partners
• Events
• Urgent Needs
• Favorites
• Organization Statistics

Contributing

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add some amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

License

This project is part of the Hearty Foundation initiative.

Support

For support, please contact the Hearty Foundation team or open an issue in this repository.