Everyone Googles for information, but who Goodles for love? Introducing Goodle—The Gemini-powered search engine for pets.

Directory Structure

• src/api: Contains all network logic.
  • client.ts: Axial instance with interceptors (handles Auth tokens automatically).
  • services/: API endpoints grouped by domain (e.g., auth.ts, pets.ts).
• src/types/api.ts: Defines the standard API response structure (ApiResponse<T>).
• src/context: Global state (e.g., AuthContext for user session).

Environment Variables

Create a local env file (gitignored) from the template:

copy .env.local.example .env.local

Then set:

VITE_API_BASE_URL=http://localhost:3000/api
GEMINI_API_KEY=your_gemini_key_here

Authentication

The AuthContext automatically handles JWT storage and injection. Ensure your login endpoint returns:

{
  "token": "jwt_token",
  "user": { "id": "...", "name": "..." }
}

🚀 Getting Started

1. Prerequisites

• Node.js (v18+)
• Python 3.9+
• Gemini API Key

2. Installation

Frontend:

npm install

Backend (Python):

# Create and activate virtual environment (Python 3.9 recommended)
/usr/bin/python3 -m venv .venv
source .venv/bin/activate

# Install dependencies
pip install -r requirements.txt -r requirements-backend.txt

3. Running the Project (Requires 2 Terminals)

Terminal 1: Backend

source .venv/bin/activate
uvicorn app.main:app --reload --port 8001
# Backend runs at http://localhost:8001

Terminal 2: Frontend

npm run dev
# Frontend runs at http://localhost:5173