🚀 Initial Docs – Main, Starters & Builders aligned

README.md

@@ -1,23 +1,75 @@
-## AI Builders Circle Site
+# Flutter AI Builders Circle 🤖
 
-The site is built with Dart utilizing the [Dart Web Platform](https://dart.dev/web) with web libraries like [`package:web`](https://pub.dev/packages/web) to interop with JS and the DOM.
+Welcome to the **Flutter AI Builders Circle** – an open-source community dedicated to building agentic Flutter applications with cutting-edge AI capabilities.
 
-We utilize [Jaspr](https://pub.dev/packages/jaspr) to provide a more Flutter centric feel to web development. Check out the [docs](https://docs.jaspr.site/) for more info.
+---
 
-## Running and building
+## 📚 Documentation Index
 
-To run the app, activate and use [`package:webdev`](https://dart.dev/tools/webdev):
+- [🔰 Starters: AI Tools & Learning Resources](./starters/README.md) – Get started with Gemini, Whisper, MCP, and more.
+- [✨ Builders: About the Community](./builders/README.md) – Learn about our mission, values, and how to contribute.
 
-```
+---
+
+## What We Offer 📦
+
+- **[Builders Community](/builders)**: Join our volunteer-led initiative to explore AI in Flutter
+- **[Starter Kits](/starters)**: Ready-to-use templates for AI integration in Flutter
+- **Community Survey**: Help shape our roadmap *(Coming Soon)*
+
+## Our Focus
+
+We’re a community of Flutter developers and AI explorers — from curious newcomers to experienced builders — learning and building together in real time.
+
+As the AI landscape evolves, so do we.  
+Instead of declaring fixed goals, our current focus is to:
+
+- 🧠 Explore how AI can enhance Flutter development  
+- 📖 Share trusted resources and working examples  
+- 🛠️ Build and test open-source prototypes and tools  
+- 🤝 Create a collaborative space for experimentation and collective learning  
+
+This is a living space — shaped by the questions we ask, the things we try, and what we discover along the way.
+
+
+## Get Involved
+
+Whether you're an AI expert or just getting started with Flutter, there's a place for you in our community.
+
+- **Explore** our starter kits to see what's possible
+- **Learn** through our sample projects and documentation
+- **Contribute** your own ideas and improvements
+- **Connect** with fellow Flutter AI enthusiasts *(Coming Soon)*
+
+## Why Flutter + AI?
+
+Flutter's cross-platform capabilities combined with modern AI services create an ideal environment for building intelligent, responsive applications that run everywhere.
+
+Our goal is to make these technologies more accessible to the entire Flutter community through high-quality examples and starter templates.
+
+## Site Info 🌐
+
+This website is built using **Dart** and the **[Jaspr](https://pub.dev/packages/jaspr)** framework to bring a Flutter-style DX to the web.
+
+To get started locally:
+
+### 🛠 Running the Site
+
+```bash
 dart pub global activate webdev
 webdev serve
 ```
 
-To build a production version ready for deployment,
-use the `webdev build` command:
+### 🧱 Building for Production
 
-```
+```bash
 webdev build
 ```
 
-To learn how to interop with web APIs and other JS libraries, check out https://dart.dev/interop/js-interop.
+To learn more about using Dart and JS together:
+👉 [JS Interop Guide](https://dart.dev/interop/js-interop)
+
+---
+
+<p align="center">Built with ❤️ by the Flutter community</p>
+

builders/README.md

@@ -0,0 +1,37 @@
+# Flutter AI Builders Circle ✨
+
+## About Us
+
+The Flutter AI Builders Circle is an open-source, volunteer-led community focused on integrating AI capabilities into Flutter applications. We bring together Flutter developers interested in building agentic apps using cutting-edge technologies like Gemini, Whisper, Multimodal Content Processing (MCP), and Retrieval-Augmented Generation (RAG).
+
+## Our Mission 🎯
+
+We aim to:
+
+- Create accessible resources for Flutter developers to incorporate AI into their apps
+- Explore and share best practices for responsible AI implementation
+- Build a supportive community for experimentation and learning
+- Develop open-source starter kits and reference implementations
+
+## What We Do 📦
+
+- **Share Knowledge**: Technical articles, code examples, and implementation guides
+- **Build Tools**: Open-source packages and utilities to simplify AI integration
+- **Provide Templates**: Ready-to-use starter projects for common AI tasks
+- **Foster Collaboration**: Connect developers working on similar challenges
+
+## Join Us
+
+**Coming Soon**
+
+We're currently preparing our community platforms. Join us to collaborate, learn, and build the future of AI-powered Flutter apps.
+
+## Contributors
+
+**Coming Soon**
+
+## Want to Contribute? 🔗
+
+We welcome contributions from Flutter developers of all experience levels! Whether you're an AI expert or just getting started, there's a place for you in our community.
+
+PRs welcome - watch this space for contribution guidelines. 

starters/README.md

@@ -0,0 +1,113 @@
+# 📦 Flutter AI Builders Circle – Starters
+
+Welcome to the **Starters Hub** of the Flutter AI Builders Circle.
+
+This section offers high-quality, community-vetted resources to help you explore and build **agentic apps** using Flutter and AI — from basic LLM integrations to more advanced workflows using RAG, MCP, and Whisper.
+
+> 🧠 We believe in learning by doing — and starting with official sources. All links below come from official documentation or deeply trusted platforms.
+
+---
+
+## 🧩 Core Concepts You Should Know
+
+### What is an Agentic App?
+
+- 🧠 [LangChain: Introduction](https://python.langchain.com/docs/introduction/) – Learn the foundations of LangChain and its modular architecture for building LLM-powered agents.
+- 📘 [What is Agentic AI? (IBM)](https://www.ibm.com/think/topics/agentic-ai#:~:text=Agentic%20AI%20solutions%20can%20be,predictive%20analytics%20and%20execute%20trades.) – Overview of how agentic AI differs from traditional AI, with real-world examples.
+- 🔍 [Introducing the Model Context Protocol (Anthropic)](https://www.anthropic.com/news/model-context-protocol) – Learn how MCP standardizes interactions between LLMs and tools.
+- 📚 [Amazon AWS: What is RAG (Retrieval-Augmented Generation)?](https://aws.amazon.com/what-is/retrieval-augmented-generation/) – A simple primer on Retrieval-Augmented Generation and how it improves model accuracy.
+- 🎥 [Observable Flutter #59 – Agentic Apps with Flutter](https://www.youtube.com/watch?v=eczLRG3q4V0&list=PLjxrf2q8roU1GHtc2FCHoEZr_v-LqnTZX) – Craig Labenz and Andrew Brogdon walk through agentic patterns, Colorist, and Firebase Genkit.
+
+---
+
+## 🔗 Official Docs & Tools Worth Exploring
+
+### LLM Integration (Gemini, OpenAI, Claude)
+
+- **Gemini API + Flutter (Colorist Codelab)** – Beginner/Intermediate. Learn how to integrate Gemini into a Flutter app using Firebase extensions and function calling.  
+  👉 [Colorist Codelab](https://codelabs.developers.google.com/codelabs/flutter-gemini-colorist)
+
+- **OpenAI API Docs** – Beginner. Covers completions, chat, and function calling for GPT models.
+  👉 [OpenAI Platform Docs](https://platform.openai.com/docs)
+
+- **dart_openai (Community SDK)** – Intermediate. A Dart package that simplifies using OpenAI APIs within Flutter projects.
+  👉 [dart_openai on pub.dev](https://pub.dev/packages/dart_openai)
+
+- **Anthropic Claude API** – Beginner. Official Claude API docs with example request/response flows.
+  👉 [Claude API Overview](https://docs.anthropic.com/claude/docs)
+
+### Speech-to-Text (Whisper)
+
+- **OpenAI Whisper API** – Beginner. Transcribe audio to text using OpenAI’s hosted Whisper model.
+  👉 [Whisper Speech-to-Text](https://platform.openai.com/docs/guides/speech-to-text)
+
+- **flutter_whisper.cpp** – Advanced. Community-maintained Flutter app running Whisper on-device via Rust FFI and whisper.cpp.
+  👉 [flutter_whisper.cpp on GitHub](https://github.com/lyledean1/flutter_whisper.cpp)
+
+### Firebase Vector Search & RAG
+
+- **Firestore Vector Search (Extension)** – Intermediate. Store and retrieve vector embeddings in Firestore for building RAG pipelines.
+  👉 [Firebase Vector Search Docs](https://extensions.dev/extensions/googlecloud/firestore-vector-search)
+
+- **Firebase Genkit** – Advanced. A backend framework for building AI-driven workflows with Gemini, designed for Cloud Functions.
+  👉 [Firebase Genkit Docs](https://firebase.google.com/docs/genkit)
+
+### MCP (Model Context Protocol)
+
+- **Model Context Protocol Overview** – Advanced. MCP is an open protocol to connect LLMs with tools and data providers.
+  👉 [Model Context Protocol Site](https://modelcontextprotocol.io/introduction)
+
+### Local LLMs (Ollama)
+
+- **Ollama** – Intermediate. Easily run LLMs like LLaMA or Mistral locally and serve them via HTTP.
+  👉 [Ollama GitHub](https://github.com/ollama/ollama)
+
+### Agentic Patterns
+
+- **Function Calling (OpenAI)** – Intermediate. Enables models to call structured functions from your app.
+  👉 [Function Calling Docs](https://platform.openai.com/docs/guides/function-calling)
+
+- **LLM Agents (Prompt Engineering Guide)** – Advanced. Explore ReAct and other reasoning/action agent patterns.
+  👉 [Prompt Engineering Agents Guide](https://www.promptingguide.ai/techniques/react)
+
+### Codelabs, Templates, and Examples
+
+- **Colorist (Gemini + Flutter)** – Intermediate. Gemini-powered Flutter app that updates the UI based on natural language prompts.
+  👉 [Colorist Codelab](https://codelabs.developers.google.com/codelabs/flutter-gemini-colorist)
+
+- **Gemini API Cookbook (GitHub)** – Intermediate/Advanced. Google’s official examples for calling Gemini API across languages including Dart.
+  👉 [Gemini Cookbook GitHub](https://github.com/google-gemini/cookbook)
+
+### Dart AI Libraries
+
+- **LangChain.dart** – Intermediate. Community Dart port of LangChain, featuring clients for OpenAI, Google, Anthropic, and more.
+  👉 [LangChain Dart on pub.dev](https://pub.dev/packages/langchain)
+
+---
+
+## 🧠 Want to Deepen Your Understanding?
+
+- 🎥 [Agentic Apps with Flutter (Observable Flutter #59)](https://www.youtube.com/watch?v=eczLRG3q4V0&list=PLjxrf2q8roU1GHtc2FCHoEZr_v-LqnTZX)
+- 💬 [Gemini Function Calling Walkthrough (Google I/O)](https://ai.google.dev/gemini-api/docs/function-calling)
+
+---
+
+## 🤝 Contribute or Join the Circle
+
+We’re building these kits and docs as a community. If you’d like to:
+
+- Submit your own starter
+- Add a resource to this list
+- Help write docs or translate examples
+
+👉 **Open a PR or stay tuned for our Slack/Discord — coming soon!**
+
+---
+
+## 🧪 Coming Next
+
+Stay tuned at **[ai.fluttercommunity.dev](https://ai.fluttercommunity.dev)**
+
+---
+
+🌱 *This space is volunteer-built with ❤️ — we aim to make agentic Flutter development more accessible for everyone.*