# AutoMinds Africa Bid Finder
Uganda-focused procurement intelligence platform by **AutoMinds Africa**.
The repository now contains a production-minded MVP foundation: Firebase Authentication, Firestore data access, a branded responsive portal, bid search, saved bids, deadline views, organization discovery, a source monitor, an admin testing utility, and an isolated Python collector workspace for the real Uganda source adapters.
## Brand asset
Add the official AutoMinds Africa logo as:
```text
public/logo.png
```
Every logo location already points to `/logo.png`. Until it is added, the interface falls back to an AutoMinds text mark instead of showing a broken image.
## Login mascot
The login screen includes **Bid Scout**, an original AutoMinds-colored procurement mascot:
- idle: “Looking for bids, I see.”
- email focus: the eyes follow the email interaction and the message changes
- password focus: the mascot covers its eyes
- sign-in: the mascot switches to scanning/loading mode
## Current stack
- Next.js + TypeScript
- Firebase Authentication
- Cloud Firestore (MVP/testing data layer)
- Firebase Analytics
- strict Firestore rules
- responsive AutoMinds blue/orange design system
- isolated Python collector scaffold
## Run locally
```bash
npm install
cp .env.example .env.local
npm run dev
```
Open `
localhost`.
The Firebase web configuration supplied for `spring-ship-456117-u8` is already used as a fallback, so `.env.local` is optional for the initial test project.
## Firebase first-time setup
1. Enable **Email/Password** in Firebase Authentication.
2. Create Firestore for project `spring-ship-456117-u8`.
3. Deploy `firestore.rules` and `firestore.indexes.json`.
4. Create a Firebase Auth user and sign in once.
5. Change that user's Firestore `/users/{uid}.role` from `viewer` to `admin`.
6. Open `/admin/bids/new` and add one test bid to validate the complete Firestore → dashboard flow.
Full steps: `docs/FIREBASE_SETUP.md`.
## Portal route …