{"id":29287507,"url":"https://github.com/403errors/ideaflowai","last_synced_at":"2025-10-10T14:03:06.380Z","repository":{"id":302473273,"uuid":"1006872279","full_name":"403errors/ideaflowai","owner":"403errors","description":"IdeaFlow AI is a web application designed to streamline the process of taking a raw idea and transforming it into a structured, developer-ready plan using AI assistance.","archived":false,"fork":false,"pushed_at":"2025-07-02T15:16:30.000Z","size":194,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-07-02T15:44:38.523Z","etag":null,"topics":["ai","fullstack","gemini-api","nextjs","tailwindcss"],"latest_commit_sha":null,"homepage":"https://studio--ideaflow-ai-tt5i0.us-central1.hosted.app/","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/403errors.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-06-23T05:59:49.000Z","updated_at":"2025-07-02T15:16:34.000Z","dependencies_parsed_at":"2025-07-02T15:44:41.545Z","dependency_job_id":"cdb7fb36-ba0f-45aa-a8b2-c63fcce2af38","html_url":"https://github.com/403errors/ideaflowai","commit_stats":null,"previous_names":["403errors/ideaflowai"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/403errors/ideaflowai","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/403errors%2Fideaflowai","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/403errors%2Fideaflowai/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/403errors%2Fideaflowai/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/403errors%2Fideaflowai/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/403errors","download_url":"https://codeload.github.com/403errors/ideaflowai/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/403errors%2Fideaflowai/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279004073,"owners_count":26083670,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-10T02:00:06.843Z","response_time":62,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","fullstack","gemini-api","nextjs","tailwindcss"],"created_at":"2025-07-06T01:40:45.794Z","updated_at":"2025-10-10T14:03:06.348Z","avatar_url":"https://github.com/403errors.png","language":"TypeScript","readme":"# \u003cimg src=\"https://firebasestorage.googleapis.com/v0/b/ideaflow-ai-tt5i0.firebasestorage.app/o/lightbulb.png?alt=media\u0026token=7cadb527-6e2e-4ede-b518-ede25fea87d9\" width=\"40\" alt=\"IdeaFlowAI Logo\"\u003e IdeaFlowAI ✨\n\n**Turn Your Spark of an Idea into a Fully-Planned Application.**\n\nIdeaFlowAI is an innovative web application that bridges the gap between a raw concept and a developer-ready plan. Using the power of generative AI, it guides you through a structured workflow to transform your initial thoughts, sketches, or documents into a comprehensive technical brief, complete with a file structure and sequential engineering prompts.\n\n![Projects Dashboard](https://firebasestorage.googleapis.com/v0/b/ideaflow-ai-tt5i0.firebasestorage.app/o/projects_dashboard.png?alt=media\u0026token=f878a967-439a-40d0-b649-c0f7e68b96fe)\n\n## 🚀 Core Features\n\n-   **AI-Powered Idea Extraction**: Automatically convert ideas from plain text, images, or PDFs into a structured markdown summary.\n-   **Adaptive Questionnaire**: Engage with a smart AI product manager that asks non-technical, multiple-choice questions to refine your idea, select features, and define the user flow.\n-   **Intelligent Tech Stack Suggestions**: Receive recommendations for the top 3 web application tech stacks, allowing you to choose the best fit for your project.\n-   **Comprehensive Plan Generation**: Synthesize all your inputs into a final, detailed application development plan.\n-   **Developer-Ready Brief**: Automatically generate a project setup prompt, a recommended file structure, and sequential, actionable engineering prompts for each feature.\n\n## 🛠️ How It Works\n\n1.  **Submit Your Idea**: Describe your app concept in any format—text, image, or PDF. Our AI gets to work understanding your vision.\n\n    ![Idea Extraction](https://firebasestorage.googleapis.com/v0/b/ideaflow-ai-tt5i0.firebasestorage.app/o/extracting_idea_from_the_file.png?alt=media\u0026token=d1fcaf89-ee3c-4db1-af1c-160a6ed8ed0d)\n\n2.  **Refine with AI**: Answer a series of smart, multiple-choice questions to build out your app's features, UI/UX, and flow. Add optional features like Authentication and Monetization with a simple click.\n\n    ![Refinement Options](https://firebasestorage.googleapis.com/v0/b/ideaflow-ai-tt5i0.firebasestorage.app/o/options_to_choose.png?alt=media\u0026token=415be832-bdf0-4f03-ab10-865180017d05)\n    ![Add-ons](https://firebasestorage.googleapis.com/v0/b/ideaflow-ai-tt5i0.firebasestorage.app/o/add_ons.png?alt=media\u0026token=6402a393-2df3-4dbc-84fd-e5308d573da5)\n\n3.  **Generate \u0026 Save Your Plan**: Receive a complete, professional development plan. Save your project to access a complete development brief, ready to be handed off to an AI developer or a human team.\n\n    ![Final Plan](https://firebasestorage.googleapis.com/v0/b/ideaflow-ai-tt5i0.firebasestorage.app/o/final_window.png?alt=media\u0026token=a714b054-51c3-4f29-8381-29c95a8acc64)\n\n## 💻 Tech Stack\n\n-   **Framework**: [Next.js](https://nextjs.org/) (App Router)\n-   **Language**: [TypeScript](https://www.typescriptlang.org/)\n-   **AI Toolkit**: [Genkit](https://firebase.google.com/docs/genkit)\n-   **AI Model Provider**: [Google AI (Gemini)](https://ai.google.dev/)\n-   **UI**: [React](https://react.dev/), [ShadCN UI](https://ui.shadcn.com/), [Tailwind CSS](https://tailwindcss.com/)\n-   **Backend \u0026 Database**: [Firebase (Firestore)](https://firebase.google.com/docs/firestore)\n-   **Authentication**: [Firebase Authentication](https://firebase.google.com/docs/auth)\n\n## 🏁 Getting Started\n\nTo run this project locally, follow these steps:\n\n### Prerequisites\n\n-   [Node.js](https://nodejs.org/) (v18 or later)\n-   A Firebase project with Firestore and Authentication enabled.\n\n### Installation\n\n1.  **Clone the repository:**\n    ```bash\n    git clone https://github.com/your-github-username/ideaflow-ai.git\n    cd ideaflow-ai\n    ```\n\n2.  **Install dependencies:**\n    ```bash\n    npm install\n    ```\n\n3.  **Set up environment variables:**\n    Create a `.env.local` file in the root of the project and add your Firebase and Google AI credentials:\n    ```env\n    # Firebase Credentials\n    NEXT_PUBLIC_FIREBASE_API_KEY=your_api_key\n    NEXT_PUBLIC_FIREBASE_AUTH_DOMAIN=your_auth_domain\n    NEXT_PUBLIC_FIREBASE_PROJECT_ID=your_project_id\n    NEXT_PUBLIC_FIREBASE_STORAGE_BUCKET=your_storage_bucket\n    NEXT_PUBLIC_FIREBASE_MESSAGING_SENDER_ID=your_messaging_sender_id\n    NEXT_PUBLIC_FIREBASE_APP_ID=your_app_id\n\n    # Google AI (Gemini) Credentials for Genkit\n    GEMINI_API_KEY=your_gemini_api_key\n    ```\n    -   You can get your Firebase credentials from your project's settings in the [Firebase Console](https://console.firebase.google.com/).\n    -   You can get your `GEMINI_API_KEY` from [Google AI Studio](https://aistudio.google.com/app/apikey).\n\n4.  **Run the development server:**\n    The application requires two processes to run concurrently: the Next.js app and the Genkit development server.\n\n    In your first terminal, start the Next.js dev server:\n    ```bash\n    npm run dev\n    ```\n\n    In a second terminal, start the Genkit dev server:\n    ```bash\n    npm run genkit:dev\n    ```\n5.  **Open the application:**\n    Navigate to [http://localhost:9002](http://localhost:9002) in your browser.\n\n    ![Login Screen](https://firebasestorage.googleapis.com/v0/b/ideaflow-ai-tt5i0.firebasestorage.app/o/login_screen.png?alt=media\u0026token=6a51642a-565f-430f-9104-9bf298f7df7e)\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F403errors%2Fideaflowai","html_url":"https://awesome.ecosyste.ms/projects/github.com%2F403errors%2Fideaflowai","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F403errors%2Fideaflowai/lists"}