⚡ Flash Acquire

Master Anything in 20 Hours.

Flash Acquire is an AI-driven study assistant that transforms complex topics into actionable mastery paths using Gemini 1.5 and evidence-based mental models. Bridge the gap between curiosity and proficiency with high-velocity learning.

---

🚀 The Philosophy

Flash Acquire is built on two primary pillars:

1. Kaufman's 20-Hour Rule: We deconstruct complex subjects into their core sub-skills, focusing on the 20% that leads to 80% of the results.
2. The Feynman Technique: Real mastery comes from being able to explain a concept in simple terms. Our AI-powered checkpoints verify your comprehension at every step.

✨ Key Features

• 🤖 AI Deconstruction: Input any subject and get a personalized, high-velocity mastery roadmap generated by Google's Gemini AI.
• 📝 Feynman Checkpoints: Verify your understanding with simplified explanations that are graded in real-time.
• ⏱️ Integrated Pomodoro Timer: Focused study sessions optimized for deep work.
• 📊 Habit Heatmap: Visualize your learning consistency with an integrated tracking system.
• 💎 Premium UI: A sleek, dark-mode interface designed for focus and visual excellence.

🛠️ Tech Stack

• Frontend: Vite + React
• Styling: Tailwind CSS
• Backend: Firebase (Authentication, Cloud Firestore, Cloud Functions)
• AI: Google Gemini 3 Flash

🏁 Getting Started

Prerequisites

• Node.js & npm
• Firebase CLI

Installation

1. Clone the repository:

   git clone https://github.com/blackghostosint/flash-aquire.git
   cd flash-aquire

2. Install dependencies:

   npm install
   cd functions && npm install && cd ..

3. Environment Setup:

   • Copy .env.example to .env in the root and fill in your Firebase credentials.
   • Copy functions/.env.example to functions/.env and add your GEMINI_API_KEY.

4. Run locally:

   npm run dev

---

Tip

To deploy Cloud Functions with secrets, use: firebase functions:secrets:set GEMINI_API_KEY

License

MIT