# PolyWeather Frontend

This directory is the only web frontend in production.

Production URL:
- https://polyweather-pro.vercel.app/

## Stack

- Next.js App Router
- Tailwind CSS
- Lucide React
- shadcn/ui base layer
- Legacy dashboard shell loaded from `public/legacy/index.html`

## Production Model

- Vercel serves the web UI
- FastAPI on VPS serves API only
- The old FastAPI static website has been removed

Current request flow:
- Browser -> Vercel frontend
- Vercel route handlers -> FastAPI API

## Local Development

```bash
cd frontend
cp .env.example .env.local
npm install
npm run dev
```

Default local URL:
- http://localhost:3000

## Required Environment Variable

```env
POLYWEATHER_API_BASE_URL=https://<your-fastapi-host>
```

Examples:
- `http://38.54.27.70:8000`
- `https://api.example.com`

## Route Handlers

Thin BFF routes currently exposed by Next:
- `GET /api/cities`
- `GET /api/city/[name]`
- `GET /api/history/[name]`

## Vercel Deployment

1. Import the repo into Vercel
2. Set Root Directory to `frontend`
3. Set `POLYWEATHER_API_BASE_URL`
4. Deploy

## Notes

- Backend CORS must allow `https://polyweather-pro.vercel.app`
- The page shell currently embeds the legacy dashboard HTML from `public/legacy/index.html`
- If you change files under `public/static`, deploy to Vercel to make them live

Last updated: 2026-03-06