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_KEY in .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

1.9 KiB Raw Blame History