Aura Craft Studio: Shared UI Framework
This repository provides a reusable UI skeleton with integrated Authentication, Theme management, and AI Connection services. It is designed to work seamlessly both in Google AI Studio (Studio Mode) and in standard deployed environments.
🌟 High-Level Overview
Aura Craft Studio is a modular foundation for building AI-powered applications. It abstracts away the complexities of:
- Authentication & RBAC: Seamless user identity management across different hosting modes.
- AI Connectivity: Pre-wired access to Google Gemini models via a secure proxy.
- Theming: A robust light/dark mode system powered by Tailwind CSS.
- Cloud Storage: Standardized operations for R2 storage (upload, download, list).
- Architecture: A strict Container/View pattern that ensures long-term scalability and code quality.
📖 Critical Documentation
🚀 instructions.md
The essential "Getting Started" guide. It details the initial setup of metadata.json and provides the Mandatory Prompt Template required for AI-accelerated feature development.
📜 rules.md
The "Source of Truth" for development boundaries. It defines which parts of the system are immutable (the "Wiring") and establishes coding standards like the 200-line file limit and modular feature grouping.
💻 Run Locally
Prerequisites: Node.js
- Install dependencies:
npm install - Set the API Key:
Set the
GEMINI_API_KEYin .env.local to your Gemini API key. - Run the app:
npm run dev
🛠️ Project Links
- AI Studio App: https://ai.studio/apps/drive/1eaFbkjczgCmq_TXULG7_eSOgkyaGX1Yk
- Organization: HumanizeIQ