Fluxboard.AI

Section 1: * About the project

## 💡 Inspiration
Electronics engineering has a steep learning curve. The jump from a clean 2D schematic to a messy physical breadboard is where most beginners fail. Inspired by the "Iron Man HUD" concept, we wanted to build a workspace where the software actually *understands* the physical board. Not just a drawing tool, but a **Digital Twin** that knows the "Metal Clip Law" of a breadboard and uses AI to bridge the gap between idea and implementation.

## ⚡ What it does
FLUXBOARD.AI provides a high-fidelity 3D digital twin of a breadboard, allowing users to upload schematics and have them automatically "routed" onto physical holes. It features a real-time DSU physics engine for connectivity, a floating AI "Circuitex" bot to help modify circuits in plain English, and a premium holographic UI for a seamless engineering experience.

## 🛠️ How we built it
The project is built on three core pillars:
1. **The DSU Physics Engine**: A **Disjoint Set Union (DSU)** graph manages electrical connectivity in real-time.
   - Total connectivity is defined by: $$ \forall u, v \in V, \text{Connected}(u, v) \iff \text{Find}(u) = \text{Find}(v) $$
2. **Gemini AI "Circuitex"**: Gemini 2.5 Flash/Pro acts as the "Logic Explorer," generating JSON patches to physically place components and wires.
3. **Holographic 3D Workspace**: Built with **React Three Fiber (Three.js)** for a premium, interactive design.

## 🧠 Challenges we ran into
- **Physical Mapping**: Translating schematic nodes to a fixed 0.1-inch grid while enforcing the "Self-Shorting" rule (ICs must span the trench).
- **AI Spatial Logic**: Prompting Gemini to return valid spatial JSON without markdown or hallucinations.
- **Responsive Layouts**: Managing a heavy 3D scene alongside drag-to-resize control panels and a real-time BOM.

## 🏆 Accomplishments that we're proud of
- Successfully implemented a **physics-accurate DSU engine** that reacts instantly to board changes.
- Created a **highly-interactive 3D UI** that feels premium and "hologrphic."
- Built a native **local file system integration** (`.fluxboard.json`) for saving and loading circuits.

## 🎓 What we learned
- **Graph Theory in UI**: Using DSU for real-time electrical net tracing.
- **AI as a Spatial Router**: Learning how to treat LLMs as co-designers for physical hardware layouts.
- **Glassmorphism at Scale**: Mastering modern CSS techniques to achieve a professional "Iron Man HUD" aesthetic.

## 🚀 What's next for Fluxboard.AI
- **WebXR Integration**: Bringing the digital twin into actual AR through headset support and mainly mobile AR versions too.
- **Full SPICE Simulation**: Visualizing in holographic AR and 3D of the current flow and voltage drops using physical and math engines like `ngspice.wasm`.
- **Collaborative Engineering**: Real-time multi-user breadboarding in the same 3D workspace.

Built With

• antigravity
• gemini
• gemini-2.5-pro
• gemini-3-flash
• gemini-3-pro
• gemini-api
• lucide-react
• next.js
• react
• react-three-fiber
• sonner
• tailwind-css
• three.js
• vite
• zustand