beno24770/Go-Ghana-V1.0
Record type:
software
Creator:
ben
Host:
# Go Ghana AI
Ghana's first budget-first AI travel planner. A smart budget estimator, itinerary builder, and tour recommendation platform for travelers planning a trip to Ghana.
## Features
- **Smart Budget Calculation**: Estimates daily costs based on traveler type, accommodation level, and duration.
- **Custom Authentication**: Secure email/password login, email verification, and session management.
- **Dynamic Recommendations**: Suggests tours and activities based on user interests.
- **AI-Powered Itineraries**: Generates personalized travel plans.
- **Real-time Updates**: Interactive form with immediate feedback.
## Tech Stack
### Frontend
- **Framework**: React 18+ (Vite)
- **Language**: TypeScript
- **Styling**: Tailwind CSS
- **State Management**: React Context (AuthContext)
- **API Client**: Fetch API with custom service layer
### Backend
- **Runtime**: Node.js + Express
- **Database**: PostgreSQL (via Supabase) with Prisma ORM
- **Authentication**: JWT (JSON Web Tokens) + HTTP-only cookies
- **Email Service**: Resend
## Getting Started
### Prerequisites
- Node.js (v18 or higher)
- PostgreSQL (or Supabase URL)
### Installation
1. **Clone the repository**:
```bash
git clone github.com
cd Go-Ghana-V1.0
```
2. **Install Frontend Dependencies**:
```bash
npm install
```
3. **Install Backend Dependencies**:
```bash
cd backend
npm install
```
### Configuration
1. **Frontend**: Create `.env` in the root:
```env
VITE_API_URL=localhost
```
2. **Backend**: Create `.env` in `/backend` (see `backend/.env.example`):
```env
DATABASE_URL="prisma+postgres://..."
JWT_SECRET="your-secret"
RESEND_API_KEY="re_..."
FRONTEND_URL="localhost"
```
### Running the App
1. **Start the Backend**:
```bash
cd backend
npm run dev
```
(Server runs on localhost)
2. **Start the Frontend** (in a new terminal):
```bash
# from root
npm run dev
```
(App runs on localhost)
## Project Structure
`` …