# Project Context

## Project Structure
- **Root:**
    - `backend/`: Go backend service.
    - `frontend/`: Astro + React frontend.
    - `Makefile`: Build commands.
    - `docker-compose.yml`: Container orchestration.

## Backend (`/backend`)
- **Language:** Go
- **Framework:** Chi (Router)
- **Database:** SQLite (with `modernc.org/sqlite` driver)
- **Authentication:** Goth (GitHub OAuth)
- **Key Directories:**
    - `internal/api/`: Handlers and routing.
        - `router.go`: Defines API routes.
        - `handlers/`: Contains logic for Auth, Repos, etc.
    - `internal/database/`: Database connection, models, and queries.
        - `models.go`: Struct definitions (`User`, `AuthToken`, `BranchState`, `DraftContent`).
        - `queries.go`: SQL queries.
        - `migrations/`: SQL migration files.
    - `internal/connectors/`: External API integrations (GitHub).
        - `github.go`: Handles GitHub API calls (listing repos, files).

## Frontend (`/frontend`)
- **Framework:** Astro (Static Site Generation / Server Side Rendering) with React islands.
- **Styling:** Tailwind CSS.
- **State Management:** React Query (TanStack Query).
- **Key Directories:**
    - `src/pages/`:
        - `index.astro`: Landing page.
        - `dashboard.astro`: Main application entry point.
    - `src/components/dashboard/`:
        - `DashboardApp.tsx`: Main React component for the dashboard.
        - `SetupWizard.tsx`: Component for selecting repository and folder (To be refactored).
        - `FileTree.tsx`: Displays repository file structure.
    - `src/lib/api/`: API client and endpoints.
        - `repos.ts`: Calls to backend repo endpoints.

## Current Functionality
1.  **Auth:** GitHub OAuth flow via `/api/auth/github/login`.
2.  **Repo Selection:** Users select a repo and optional folder path via `SetupWizard`.
3.  **File Listing:** Fetches file tree from GitHub via Backend. Currently shows all folders, even empty ones.
4.  **Editing:** Markdown editing (implied, likely using TipTap or similar based on `node_modules`).

## Proposed Changes Context
- **Last Repo Persistence:** Currently, the app doesn't remember the selected repo across sessions. We need to add `last_repo` to the `User` model.
- **Folder Selection:** The user finds the folder selection step unnecessary. We will enforce root (`""`) as the default.
- **Empty Folders:** The file tree currently is "dumb" and shows the full structure. We need to make the backend filtering "smart" to only return relevant paths.
- **Navigation:** The dashboard currently handles both setup and editing in one view. Splitting this into `/select-repo` and `/dashboard` will improve UX and browser history management.