Morocco's AI-native bug bounty platform — GDG Agadir Hackathon. Powered by Gemini AI & Google Cloud.
# BroadSec — Morocco's AI Bug Bounty Platform
> Built at GDG Agadir Vibe Coding Hackathon · Powered by Gemini AI · Deployed on Google Cloud
Morocco's first AI-native vulnerability disclosure platform — connecting companies with security researchers, with Gemini AI at the core.
---
## Prize Targets
| Prize | Criteria | How We Win |
|-------|----------|-----------|
| 🥇 1st — 1000 DH | Best Use of Gemini API | 6 distinct AI features: Triage, Explainer, Fix Generator, Report Writer, Translator, Scope Analyzer |
| 🥈 2nd — 700 DH | Best Deployed App on Google Cloud | Firebase Hosting + Cloud Run + Firestore + Gemini via Google AI Studio |
| 🥉 3rd — 500 DH | IdeaHack Award | CNSS breach story · Saudi Arabia precedent · Morocco-first |
---
## Stack
```
Frontend Next.js 14 · TypeScript · Tailwind CSS · shadcn/ui
Backend Python FastAPI → Docker → Cloud Run
Database Firebase Firestore
Auth Firebase Authentication
AI Google Gemini API (gemini-2.0-flash)
Storage Firebase Storage
Hosting Firebase Hosting + Cloud Run
```
---
## Project Structure
```
broadsec/
├── frontend/ # Next.js app
│ ├── app/
│ │ ├── page.tsx # Landing page (from Emergent, polished)
│ │ ├── scanner/ # Live scanner section
│ │ ├── programs/ # Bug bounty programs list
│ │ ├── submit/ # Report submission (AI-assisted)
│ │ ├── leaderboard/ # Hall of Fame
│ │ └── api/
│ │ ├── scan/ # → Python scanner or inline checks
│ │ ├── triage/ # → Gemini AI triage
│ │ └── translate/ # → Gemini multilingual
│ ├── components/
│ │ ├── ui/ # shadcn components
│ │ ├── sections/ # Landing page sections
│ │ └── layout/ # Navbar, Footer
│ ├── lib/
│ │ ├── gemini.ts # All 6 Gemini AI features
│ │ ├── scanner.ts # Scanner client helpers
│ │ └── mock-data.ts # Demo p …