NeuraOS

NeuraOS – A Gemini-powered WebOS that brings a full desktop experience to your browser, with secure login, wallet-based onchain saving, and AI-assisted productivity apps.

Comment

🚀 Inspiration

We wanted to build something ambitious — a full-featured WebOS inside your browser. Inspired by modern operating systems, productivity tools, and the need for decentralized, secure digital environments, NeuraOS was born.

Our goal was to create a browser-based OS that:

  • Combines multiple desktop-like apps (Notes, Terminal, Code Editor, File Manager, Browser, Calendar)
  • Uses Supabase for off-chain storage and authentication
  • Uses Solana/EVM wallets for on-chain signing and secure data handling
  • Integrates Gemini AI to assist users in all apps with coding, summarizing, chatting, and more

It’s the OS we wish existed — and now it does.

🧠 What it does

NeuraOS is a fully functional Web-based Operating System, powered by AI and blockchain, with:

  • User Authentication (Supabase): Email + password login system
  • Optional Wallet Connect (Phantom/MetaMask): For secure on-chain saves
  • File Manager: Upload/download files, with on-chain/off-chain logic
  • Notes App: Write, save, summarize with Gemini
  • Calendar App: Add/view events, smart reminders
  • Terminal App: Run commands like ls, /ask, clear, etc.
  • AI Chat App: Ask anything, get code, summaries, explanations
  • Code Editor: Multi-language support (TS, JS, Python, Java, etc.) with built-in console and Gemini Copilot
  • Settings App: Save wallpapers, themes, layout preferences
  • Smart Logic: Every save asks “Is this important?” → store on-chain or off-chain accordingly
  • State Persistence: App states are saved, reopened, and reloaded seamlessly

🛠️ How we built it

Frontend:

  • React.js + Vite + Tailwind CSS for blazing-fast UI
  • Drag & Drop window manager with focus, resize, z-index control
  • Dynamic app launcher and multi-window support

Backend & Storage:

  • Supabase (auth, real-time DB, storage buckets)
  • Custom Supabase RLS policies to secure user data per session
  • Supabase buckets for file storage (off-chain)

Blockchain Integration:

  • Solana Wallet Adapter + Phantom
  • MetaMask for EVM Support
  • On-chain logic to sign and commit “important” files
  • Placeholder Solidity/Rust contract integrations

AI:

  • Gemini API (Google AI) integrated across:

    • Notes
    • Terminal
    • Code Editor
    • AI Chat

Code Execution:

  • Pyodide for Python
  • Safe in-browser JS/TS eval
  • Monaco Editor for code highlighting and built-in output console

🚧 Challenges we ran into

  • Supabase RLS Errors (42501, unauthorized): Required fine-tuned policies
  • Wallet & Auth sync: Avoiding auto-login bugs, wallet validation logic
  • Data loss: Ensuring save/load logic across all apps
  • Gemini bugs: API failures, rate limits, and UI handling of long outputs
  • App state management: Avoiding flickering and broken internal states
  • File system sync: Making File Manager reflect saved content across apps
  • iframe blocking: Handling Google login and external links in the browser app
  • Bugs under pressure: Many logical flows stopped working when rushed

🏆 Accomplishments that we're proud of

  • Built a fully modular, multi-app browser OS
  • Combined Web2 + Web3 + AI in one seamless system
  • Smart onchain/offchain storage logic with wallet signing
  • Live multi-language code editor with execution and AI assistant
  • Achieved a production-grade UX with minimal external dependencies

📚 What we learned

  • Deep understanding of Supabase RLS and real-time sync
  • Smart wallet logic separation from login flow
  • Dynamic app routing and multi-window handling in React
  • Managing complex state across isolated React apps
  • AI integration into product workflows (not just chatbot use)
  • Building scalable architectures even under time pressure

🔮 What's next for NeuraOS

  • Fully functional offline mode using IndexedDB and localStorage
  • Real-time shared desktops (multi-user sessions)
  • Blockchain contract deployment (Solana and EVM) with real asset save
  • Plugin support (custom apps by users)
  • AI-first desktop: Let AI generate apps, flows, or themes on command
  • Marketplace for themes, apps, wallpapers, and file templates
  • Hardware wallet support and privacy mode
  • Mobile-friendly version for tablets and phones

Built With

Share this project:

Updates