Andy-Fidel/GTVET-Info-Portal

Ghana TVET Information Portal - React + laravel # Ghana TVET Service Information Portal A comprehensive web application for Ghana's Technical and Vocational Education and Training (TVET) sector. This portal serves as a central hub for TVET institutions, programs, and information. ## 🎯 Project Overview The Ghana TVET Service Information Portal is built with: - **Frontend**: React 18 with Vite + shadcn/ui for modern component architecture - **Backend**: Laravel 10 REST API - **Styling**: Tailwind CSS with shadcn/ui components - **State Management**: Zustand for lightweight state management - **Hosting**: Optimized for cPanel shared hosting environments ## 📋 Features ### For Students & Job Seekers - Browse accredited TVET institutions - Search and filter training programs by category and duration - View institution details and contact information - Read latest announcements and news - Contact institutions directly through the portal ### For Administrators - Manage institutions and programs - Post announcements and updates - Manage contact form submissions - User management system ### Core Features - ✅ Responsive design (mobile, tablet, desktop) - ✅ Search and filtering functionality - ✅ Institution and program directories - ✅ News/Announcements section - ✅ Contact form with email notifications - ✅ API-driven architecture - ✅ Security headers and CORS configuration - ✅ Performance optimized ## 🚀 Quick Start ### Prerequisites - **Node.js** 16+ and npm - **PHP** 8.1+ - **Composer** - **MySQL** 5.7+ - **Git** ### Local Development Setup #### 1. Clone and Setup Frontend ```bash cd frontend npm install npm run dev ``` Frontend will be available at `localhost` #### 2. Setup Backend ```bash cd backend # Copy environment file cp .env.example .env # Install dependencies composer install # Generate app key php artisan key:generate # Run migrations php artisan migrate --seed # Start server php artisan serve ``` Backend API will be available at `localhost` ### Environment Variables …