Near Me

Near Me is a Flutter project with a Python FastAPI backend.

The mobile/web/desktop client lives in the root Flutter app, and the backend API lives in lib/backend/app.

Tech Stack

• Flutter (frontend)
• FastAPI + Uvicorn (backend)
• Python dependencies in lib/backend/app/requirements.txt

Prerequisites

• Flutter SDK installed and available in PATH
• Python 3.10+ installed
• pip installed

Project Structure

• lib/main.dart: Flutter app entry point
• lib/backend/app/main.py: FastAPI app entry point
• lib/backend/app/requirements.txt: backend Python packages

Starting The Project

1. Install Flutter packages (from project root):

   flutter pub get

2. Install backend packages (from lib/backend/app):

   pip install -r requirements.txt

3. Start the backend API (from lib/backend/app):

   uvicorn main:app --reload --host 0.0.0.0 --port 8000

4. In a new terminal, start Flutter app (from project root):

   flutter run

Verify Backend

Open this URL after starting the backend:

• http://127.0.0.1:8000/

You should get the default greeting response from the FastAPI route.

Notes

• Keep backend and Flutter running in separate terminals during development.
• Use flutter devices to list available run targets.