{"id":19218477,"url":"https://github.com/trups39/ai-story-builder","last_synced_at":"2026-05-02T20:34:04.914Z","repository":{"id":261502983,"uuid":"884438610","full_name":"Trups39/AI-Story-Builder","owner":"Trups39","description":"AI powered story builder SaaS app to create and share imaginative stories with AI-driven content and real-time image generation.","archived":false,"fork":false,"pushed_at":"2024-11-06T21:44:28.000Z","size":17987,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-01-04T19:21:34.889Z","etag":null,"topics":["gemini-api","nextjs","react","replicate-api","typescript"],"latest_commit_sha":null,"homepage":"","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/Trups39.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}},"created_at":"2024-11-06T18:49:16.000Z","updated_at":"2024-12-21T21:14:45.000Z","dependencies_parsed_at":"2024-11-06T22:47:33.549Z","dependency_job_id":null,"html_url":"https://github.com/Trups39/AI-Story-Builder","commit_stats":null,"previous_names":["trups39/ai-story-builder"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Trups39%2FAI-Story-Builder","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Trups39%2FAI-Story-Builder/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Trups39%2FAI-Story-Builder/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Trups39%2FAI-Story-Builder/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Trups39","download_url":"https://codeload.github.com/Trups39/AI-Story-Builder/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":240292381,"owners_count":19778311,"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","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":["gemini-api","nextjs","react","replicate-api","typescript"],"created_at":"2024-11-09T14:26:55.136Z","updated_at":"2026-05-02T20:33:58.527Z","avatar_url":"https://github.com/Trups39.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\n# AI Kids Story Generator App\n\n## Overview\nThe **AI Kids Story Generator** app enables users to create kids' stories with the help of AI. It integrates technologies such as React, Next.js, NextUI, TypeScript, and provides a seamless experience for generating stories and images based on user inputs. The app incorporates a credit system to manage story creation.\n\n## Features\n- **Landing Page**: Login/signup screen with Clerk authentication.\n- **Dashboard**: View and manage stories, track credits, and user statistics.\n- **Story Creation**: Form to input story details like subject, type, age group, and image style.\n- **AI Integration**: Generates stories using the Gemini AI API and images using the Replicate API.\n- **Credit System**: Allows for the limitation of story generation and the option to purchase more credits.\n\u003cimg width=\"1093\" alt=\"image\" src=\"https://github.com/user-attachments/assets/cf0fcbd8-05c6-44b7-8c86-35e6eedf2d69\"\u003e\n\u003cimg width=\"1104\" alt=\"image\" src=\"https://github.com/user-attachments/assets/cef121df-be2e-43e2-b296-ec0b090e69bc\"\u003e\n\u003cimg width=\"1028\" alt=\"image\" src=\"https://github.com/user-attachments/assets/503a39d2-3134-4cbf-afdb-a1a5d543140e\"\u003e\n\u003cimg width=\"804\" alt=\"image\" src=\"https://github.com/user-attachments/assets/cbf05dc7-65f4-4fd0-ac97-1462ba7485d8\"\u003e\n\n\n\n\n## Prerequisites\n- Knowledge of JavaScript and React.\n- Node.js and npm installed.\n- Familiarity with TypeScript (optional).\n- GitHub account.\n\n## Setup\n\n### 1. Create Next.js Project:\n```bash\nnpx create-next-app@latest --typescript\n```\n\n### 2. Install NextUI:\nTo install NextUI in your project, run the following command:\n```bash\nnpm install @nextui-org/react\n```\n\n### 3. Initialize Clerk Authentication:\nFollow the Clerk documentation for setting up authentication in your app.\n\n## Designing the App\n\n### Landing Page\n- **Description**: A login/signup screen to authenticate users.\n- **Technology**: Clerk for user authentication.\n\n### Dashboard\n- **Description**: View stories, credits, and user statistics.\n- **Features**: \n  - Track user credits.\n  - View list of generated stories.\n  - See personal user statistics.\n\n### Story Creation Form\n- **Inputs for**:\n  - **Subject**: The main theme of the story.\n  - **Type**: Type of the story (e.g., adventure, fantasy).\n  - **Age Group**: Intended age range for the story (e.g., 3-5, 6-8).\n  - **Image Style**: Style of images to accompany the story (e.g., cartoon, realistic).\n\n### Story Viewer\n- **Description**: Display generated stories for the user to read and view.\n- **Features**: \n  - Display the text story generated by the Gini AI API.\n  - Show related images generated by the Replicate API.\n\n## AI Integration\n\n### Gemini AI API\n- **Description**: Use Gemini AI to generate text stories based on user input.\n- **Integration**: The AI generates stories using subject, type, age group, and image style.\n\n### Replicate API\n- **Description**: Generate images that correspond to the stories using Replicate API.\n- **Integration**: Use the story data (subject, type) to generate appropriate images using Replicate.\n\n## User Authentication\n- **Description**: Use Clerk for user sign-in and registration.\n- **Features**: \n  - Protect routes and check authentication status in your app.\n  - Ensure that only authenticated users can create stories.\n\n## Dashboard\n- **Description**: Display story statistics, credits, and a list of generated stories.\n- **Features**:\n  - Implement pagination for easy navigation through the user's created stories.\n  - Show credits balance and usage history.\n\n## Story Creation Workflow\n\n### Input\n- **Description**: The user provides details such as:\n  - Subject\n  - Type\n  - Age group\n  - Image style\n\n### Credit Check\n- **Description**: Verify the user's available credits to generate a new story.\n- **Logic**: Ensure that users have sufficient credits before initiating story generation.user can buy credits with paypal\n\n### Story Generation\n- **Description**: Generate the story using AI and deduct credits from the user account.\n- **Process**: \n  - Call the Gemini API to create a story.\n  - Call Replicate API to generate an image.\n  - Deduct credits after successful generation.\n\n\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftrups39%2Fai-story-builder","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftrups39%2Fai-story-builder","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftrups39%2Fai-story-builder/lists"}