⚡ CircuitPal.AI

AI-powered electronics project planning, from idea to checkout.

Built by Team SillyCodeValley for FEU Hackathon 2026 Proudly integrated with CircuitRocks

---

Table of Contents

• Overview
• Features
• Tech Stack
• Prerequisites
• Installation & Setup
• Running the Application
• Project Structure
• How to Use
• Team
• License

---

Overview

CircuitPal.AI is an AI-powered electronics project planning assistant that helps makers and hardware enthusiasts design, plan, and manage their builds without drowning in browser tabs, scattered parts lists, and guesswork inventory tracking.

Describe a project idea, and CircuitPal.AI's assistant — powered by Gemini 2.5 Flash — analyzes the requirements, generates a complete Bill of Materials, checks it against live CircuitRocks stock and pricing, and lays out a step-by-step roadmap to get from concept to first solder.

Features

Feature	Description
🤖 AI Copilot	Describe your project idea and get instant component recommendations and design guidance from Gemini 2.5 Flash.
📋 Auto BOM Generation	Automatically builds a complete Bill of Materials based on your project's engineering requirements.
📦 Stock Tracking	View live CircuitRocks stock availability and a dynamic price estimator directly in the BOM side panel.
🗺️ Project Planning	Generates step-by-step roadmaps covering acquisition, assembly, and testing.
🧰 Inventory Management	Tracks components you already own so you never buy duplicates.
🔗 External Component Sourcing	Provides purchase links to external vendors for any part not available on CircuitRocks.

Tech Stack

Layer	Technologies
Frontend	React 19, TypeScript, Tailwind CSS, Vite, Lucide React
Backend	Node.js, Express, TypeScript, Google Generative AI (Gemini)
Monorepo Management	npm workspaces, concurrently

Prerequisites

Make sure you have the following installed before getting started:

• Node.js v18 or higher
• npm (Node Package Manager)

Installation & Setup

1. Clone the repository

git clone https://github.com/sillyCodeValley1/FEU-HACKATHON-2026.git
cd FEU-HACKATHON-2026

2. Install dependencies

This installs root, frontend, and backend dependencies in one go:

npm run install:all

3. Configure environment variables

Navigate to the backend directory and create a .env file:

cd backend
touch .env

Add your Google Gemini API key:

GEMINI_API_KEY=your_gemini_api_key_here

💡 No API key? No problem — the app gracefully falls back to mock AI responses so you can still explore the full experience.

Running the Application

From the root directory, start both servers at once:

npm run dev

Service	URL
Frontend	http://localhost:5173
Backend API	http://localhost:4000

Project Structure

├── backend/                # Express backend application
│   ├── src/                # API endpoints, AI integration
│   ├── package.json
│   └── tsconfig.json
├── frontend/                # React frontend application
│   ├── src/                # Components, pages, utilities
│   ├── package.json
│   ├── vite.config.ts
│   └── tailwind.config.js
└── package.json            # Root configuration and concurrent scripts

How to Use

1. Start a project — click "Start Building Now," then name your project.
2. Log your inventory — enter the components you already have before planning.
3. Chat with the AI Copilot — describe your idea, your budget, or ask for help finding parts.
4. Review your BOM — check stock and pricing, and uncheck anything you don't want to buy.
5. Buy Selected — checkout directly through CircuitRocks.
6. Follow your roadmap — tick off tasks in the planner as you build.

Team

Name	Role
Bakhsh, Abdullah	Backend Developer
Ignacio, Lorraine Bernadette P.	Pubmat
Laquindanum, Gabriel Angelo D.	Full-Stack Developer
Ronsairo, Gabrian Allen A.	Frontend Developer

License

Created for FEU Hackathon 2026. Licensed under ISC.