A sophisticated landing page for QuantumOS - a decentralized physics computation protocol combining blockchain technology with statistical physics simulations.
QuantumOS is a Proof-of-Useful-Work (PoUW) blockchain system that leverages distributed computing for 2D Ising model simulations. This landing page showcases the project's features, roadmap, and includes an interactive Ising model simulator with AI-powered technical assistance.
- Interactive Ising Model Simulator: Real-time 2D Ising lattice physics simulation with adjustable parameters
- AI Technical Assistant: Powered by Google's Gemini AI to answer questions about the project
- Project Roadmap: Timeline visualization of development phases and milestones
- Responsive Design: Fully responsive interface with a scientific/research aesthetic
- Modern Tech Stack: Built with React 19, TypeScript, and Vite
- Frontend Framework: React 19.2.3
- Language: TypeScript 5.8.2
- Build Tool: Vite 6.2.0
- Styling: TailwindCSS (via CDN)
- AI Integration: Google Generative AI SDK
- Fonts: Lora (serif), JetBrains Mono (monospace), Inter (sans-serif)
quanum-os/
├── components/
│ ├── Navbar.tsx # Navigation bar
│ ├── Hero.tsx # Hero section
│ ├── Features.tsx # Features showcase
│ ├── Roadmap.tsx # Development roadmap
│ ├── IsingSimulator.tsx # Interactive physics simulator
│ ├── TechnicalAssistant.tsx # AI chat assistant
│ └── Footer.tsx # Footer component
├── App.tsx # Main application component
├── index.tsx # Application entry point
├── types.ts # TypeScript type definitions
├── index.html # HTML template
└── vite.config.ts # Vite configuration
- Node.js (v16 or higher recommended)
- npm or yarn package manager
-
Clone the repository:
git clone <repository-url> cd quanum-os
-
Install dependencies:
npm install
-
Set up environment variables:
- Create a
.env.localfile in the root directory - Add your Gemini API key:
GEMINI_API_KEY=your_api_key_here
- Create a
Run the development server:
npm run devThe application will be available at http://localhost:3000
Build the application:
npm run buildThis will generate optimized production files in the dist directory.
Preview the production build:
npm run previewnpm run dev- Start development server with hot reloadnpm run build- Build production-ready applicationnpm run preview- Preview production build locally
Interactive 2D Ising model simulation featuring:
- Adjustable temperature and coupling strength
- Real-time lattice visualization
- Entropy and energy calculations
- GPU-acceleration ready architecture
AI-powered chat interface that:
- Answers technical questions about QuantumOS
- Explains physics concepts and implementation details
- Powered by Google's Gemini AI model
Three-phase development timeline:
- Phase I: Fundamental Lattice (Complete)
- Phase II: Network Equilibrium (In Progress)
- Phase III: Universal Field (Planned)
The interface adopts a scientific research aesthetic with:
- Dark theme optimized for extended viewing
- Monospaced fonts for technical accuracy
- Subtle grid background mimicking graph paper
- Blueprint-style borders and decorative elements
- Amber accent colors for visual hierarchy
| Variable | Description | Required |
|---|---|---|
GEMINI_API_KEY |
Google Gemini API key for AI assistant | Yes |
- Modern browsers with ES6+ support
- Chrome/Edge 90+
- Firefox 88+
- Safari 14+
- Initial bundle size: ~474 KB (gzipped: ~119 KB)
- Build time: <1 second
- Optimized with Vite's production mode
- Code splitting enabled for optimal loading
Contributions are welcome. Please follow these guidelines:
- Fork the repository
- Create a feature branch
- Make your changes with clear commit messages
- Test the build process
- Submit a pull request
This project is private and proprietary.
For questions or support, please refer to the project documentation or contact the development team.
Built with precision for the advancement of decentralized scientific computation.