ShopBrain

Inspiration

Running a local business is chaotic. Shop owners constantly juggle inventory, customer messages, appointment bookings, and marketing—all while trying to provide great service on the floor. They rarely have the time to sit at a computer all day, nor the budget to hire a dedicated operations manager. We realized that recent advancements in AI, particularly models like Gemini, could automate the repetitive aspects of running a shop. We built ShopBrain to be an autonomous, 24/7 AI operations manager that works alongside the business owner to effortlessly streamline daily tasks

What it does

ShopBrain is a comprehensive, AI-powered dashboard that centralizes local business operations: Smart Inbox: An AI agent intercepts incoming customer messages, answers common questions, and attempts to resolve inquiries automatically. If the AI detects it can't handle a complex request, it flags it for the business owner to take over smoothly. Intelligent Inventory Manager: Allows shop owners to manage stock levels gracefully. A visual shelf-scanning interface lays the groundwork for AI to automatically deduce what is running low. AI Promotions & Marketing: Owners can generate targeted marketing campaigns on the fly. The system suggests creative, high-converting copy based on the local shop's context, ready to be dispatched to their customer base. Global AI Co-pilot: A persistent, context-aware ShopBrain assistant lives in the bottom corner of the app. Owners can ask it questions, have it draft messages, or get operational insights at any moment.

How we built it

We architected ShopBrain as a robust, real-time full-stack application: Frontend: Built with React, TypeScript, and Vite. We styled it meticulously with Tailwind CSS to provide a dark, modern, neon-accented professional dashboard experience, utilizing motion/react for fluid state transitions. Backend: Powered by a custom Node.js/Express server that safely masks our API secrets. Database & State: We integrated Firebase (Authentication and Cloud Firestore) to provide instant, real-time data syncing across the dashboard—so when a message comes in or inventory updates, the UI reacts immediately. AI Integration: We utilized the Gemini API (gemini-3.5-flash), proxied securely through our backend, to power the conversational AI inbox, the global assistant reasoning, and the promotional content generation capabilities.

Challenges we ran into

One of our biggest hurdles was seamlessly blending AI autonomy with human oversight. In the Inbox feature, managing the hand-off between the AI auto-responder and the human business owner required complicated component state and real-time syncing via Firebase. Additionally, configuring the Express backend to securely handle Gemini inference while bundling cleanly with the Vite development environment required advanced build configuration. Finally, ensuring proper data security with Firebase Firestore rules took careful troubleshooting.

Accomplishments that we're proud of

We are incredibly proud of the sleek, intuitive User Interface. Often, B2B software designed for small local businesses is clunky and outdated; ShopBrain feels like a premium, futuristic tool. We're also immensely proud of the real-time "Global Assistant" integration—having an omni-present AI capable of reading conversation history and helping the owner navigate their own business data is a magical user experience.

What we learned

We learned a massive amount about creating real-time experiences where one of the active participants is an AI. We heavily refined our prompt engineering skills, discovering how to inject strict system instructions to keep the Gemini model acting reliably as a "Shop Manager" without breaking character or hallucinating. We also solidified our understanding of secure full-stack architectures, ensuring API keys never leak to the client side.

What's next for ShopBrain

In the future, we want to fully build out the multimodal visual inference capabilities—allowing owners to stream live video of their store shelves and have Gemini natively update the Firebase inventory database. We also plan to integrate the WhatsApp Business API natively into the Smart Inbox so ShopBrain can talk directly to real customers on their preferred platforms. Finally, we want to introduce predictive financial analytics—using historical data to tell the owner exactly what to restock ahead of busy seasonal holidays.

Built With

• and
• built-with-react-(frontend-ui)
• firebase-authentication-(anonymous-user-auth)
• firebase-firestore-(real-time-nosql-database)
• framer-motion-(smooth-animations-&-transitions)
• lucide
• node.js/express-(backend-api-&-server)
• react
• tailwind-css-(utility-first-styling)
• typescript-(type-safety-&-scalable-architecture)
• vector
• vite-(lightning-fast-build-tool)