Clusters is a premium, AI-native intelligence workspace designed for recursive knowledge mapping. It transforms static data into a living archive of interconnected neural nodes, powered by Gemini 2.0 and Cloud Firestore.
- 🌐 Recursive Neural Mapping: Create infinite hierarchies of clusters and sub-nodes. Every node is a potential gateway to a deeper layer of data.
- 🧬 Dynamic Node Schema: Define your own data "columns" on the fly. Add custom metadata attributes—from security levels to hardware metrics—per node.
- 🧠 Gemini AI Integration: Context-aware intelligence assistant that helps analyze, summarize, and navigate your entire cluster matrix.
- 🔍 Global Matrix Search: High-performance recursive search engine find any node across the entire hierarchy instantly with breadcrumb navigation.
- 🌑 Obsidian Midnight Aesthetic: A high-fidelity, ink-based dark theme with advanced glassmorphism and refractive surfaces.
- Framework: Next.js 15 (App Router)
- Database: Google Cloud Firestore
- Authentication: Firebase Auth (Google OAuth)
- Intelligence: Google Gemini 2.0 Flash
- Animation: Framer Motion
- Styling: Tailwind CSS v4 & Native CSS Variables
Ensure you have Node.js 18+ installed on your system.
Clone the repository and create your .env.local file:
NEXT_PUBLIC_FIREBASE_API_KEY="..."
NEXT_PUBLIC_FIREBASE_AUTH_DOMAIN="..."
NEXT_PUBLIC_FIREBASE_PROJECT_ID="..."
NEXT_PUBLIC_FIREBASE_STORAGE_BUCKET="..."
NEXT_PUBLIC_FIREBASE_MESSAGING_SENDER_ID="..."
NEXT_PUBLIC_FIREBASE_APP_ID="..."
GEMINI_API_KEY="..."# Install dependencies
npm install
# Run the development server
npm run devsrc/
├── app/ # Next.js App Router & Global Styles
├── components/ # Atomic UI & Matrix-specific components
├── context/ # Theme & Auth State Management
├── hooks/ # Recursive Node Logic & Search
├── lib/ # Firebase & External SDKs
└── assets/ # Static high-fidelity visuals
The platform features a Dual-Axis Visual System:
- Themes: Switch between "Light Editorial" and "Obsidian Midnight".
- Surfaces: Toggle between "Brutal Solid" and "Refractive Glass" rendering.
We welcome contributions to the intelligence matrix. Please feel free to open a PR or Issue.
MIT © Ritvik718