{"id":28468517,"url":"https://github.com/nextgengk/gitdocs-ai-powered-readme-generator","last_synced_at":"2025-06-25T20:30:48.860Z","repository":{"id":297595551,"uuid":"995698103","full_name":"NextGenGk/GitDocs-AI-Powered-Readme-Generator","owner":"NextGenGk","description":"Paste any GitHub repository link and get a fully formatted README.md in seconds. Includes project title, badges, features, installation steps, usage guide, license, contribution instructions, and contact info — all in clean, structured Markdown. Ideal for open-source projects, portfolios, and hackathons.","archived":false,"fork":false,"pushed_at":"2025-06-13T20:21:23.000Z","size":5451,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-06-13T21:27:07.890Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://git-docs-ai-powered-readme-generato-seven.vercel.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/NextGenGk.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-03T22:03:55.000Z","updated_at":"2025-06-13T20:22:43.000Z","dependencies_parsed_at":"2025-06-06T10:30:49.614Z","dependency_job_id":"2a0b30f1-0a0e-4de2-b0cc-ce1b670d84de","html_url":"https://github.com/NextGenGk/GitDocs-AI-Powered-Readme-Generator","commit_stats":null,"previous_names":["nextgengk/gitdocs-ai-powered-readme-generator"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/NextGenGk/GitDocs-AI-Powered-Readme-Generator","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NextGenGk%2FGitDocs-AI-Powered-Readme-Generator","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NextGenGk%2FGitDocs-AI-Powered-Readme-Generator/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NextGenGk%2FGitDocs-AI-Powered-Readme-Generator/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NextGenGk%2FGitDocs-AI-Powered-Readme-Generator/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/NextGenGk","download_url":"https://codeload.github.com/NextGenGk/GitDocs-AI-Powered-Readme-Generator/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/NextGenGk%2FGitDocs-AI-Powered-Readme-Generator/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":261948754,"owners_count":23234884,"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":[],"created_at":"2025-06-07T08:07:48.921Z","updated_at":"2025-06-25T20:30:48.855Z","avatar_url":"https://github.com/NextGenGk.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# GitHub to Markdown Converter\n\nA web application that converts GitHub repository links to polished README.md files using AI. The application allows users to input a GitHub repository URL, generates a comprehensive README.md file, and provides options to edit and download the result.\n\n## Features\n\n- Convert GitHub repository links to README.md files\n- AI-powered content generation using Google's Gemini API\n- User authentication with Clerk\n- Edit generated markdown content in the browser\n- Download the final README.md file\n- Responsive design for desktop and mobile\n\n## Prerequisites\n\n- Node.js 18.x or later\n- A Google Gemini API key\n- A Clerk account for authentication\n\n## Getting Started\n\n### 1. Clone the repository\n\n```bash\ngit clone https://github.com/yourusername/gitdocs-api.git\ncd gitdocs-api\n```\n\n### 2. Install dependencies\n\n```bash\nnpm install\n# or\nyarn install\n# or\npnpm install\n```\n\n### 3. Set up environment variables\n\nCreate a `.env.local` file in the root directory with the following environment variables:\n\n```\nGEMINI_API_KEY=your_gemini_api_key_here\nNEXT_PUBLIC_CLERK_PUBLISHABLE_KEY=your_clerk_publishable_key_here\n```\n\n#### Getting your Clerk Publishable Key:\n\n1. Go to [Clerk Dashboard](https://dashboard.clerk.com)\n2. Sign up or log in to your account\n3. Create a new application or select an existing one\n4. Navigate to the \"API Keys\" section\n5. Copy your \"Publishable key\" (it starts with `pk_test_` or `pk_live_`)\n6. Add it to your `.env.local` file\n\n#### Getting your Gemini API Key:\n\n1. Go to [Google AI Studio](https://ai.google.dev/gemini-api)\n2. Sign in with your Google account\n3. Create a new API key\n4. Add it to your `.env.local` file\n\nYou can use the `.env.local.example` file as a template.\n\n### 4. Run the development server\n\n```bash\nnpm run dev\n# or\nyarn dev\n# or\npnpm dev\n```\n\nOpen [http://localhost:3000](http://localhost:3000) with your browser to see the application.\n\n## Usage\n\n1. Sign in to your account using Clerk authentication\n2. Enter a GitHub repository URL in the input field (e.g., https://github.com/username/repository)\n3. Click the \"Generate README\" button\n4. Wait for the AI to generate the README.md content\n5. Edit the generated content in the textarea if needed\n6. Click the \"Download README.md\" button to save the file\n\n## How It Works\n\nThe application uses the following process:\n\n1. The user authenticates through Clerk\n2. The user submits a GitHub repository URL through the web interface\n3. The application validates the URL format\n4. The backend makes a request to the Google Gemini API with a specialized prompt\n5. The AI generates a comprehensive README.md file based on the repository\n6. The generated content is displayed in an editable textarea\n7. The user can download the final README.md file\n\n## API Reference\n\n### POST /api/github-to-markdown\n\nConverts a GitHub repository URL to a README.md file.\n\n**Request Body:**\n\n```json\n{\n  \"githubUrl\": \"https://github.com/username/repository\"\n}\n```\n\n**Response:**\n\n```json\n{\n  \"markdown\": \"# Repository Name\\n\\nDescription of the repository...\"\n}\n```\n\n## Technologies Used\n\n- [Next.js](https://nextjs.org/) - React framework\n- [TypeScript](https://www.typescriptlang.org/) - Type-safe JavaScript\n- [Clerk](https://clerk.com/) - Authentication and user management\n- [Google Gemini API](https://ai.google.dev/gemini-api) - AI content generation\n- [Tailwind CSS](https://tailwindcss.com/) - Styling\n\n## Environment Variables\n\nMake sure to set up the following environment variables in your `.env.local` file:\n\n- `GEMINI_API_KEY` - Your Google Gemini API key\n- `NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY` - Your Clerk publishable key\n\n## Troubleshooting\n\n### Clerk Authentication Error\n\nIf you see an error about an invalid Clerk publishable key:\n\n1. Make sure you have created a `.env.local` file in the root directory\n2. Verify that your `NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY` is set correctly\n3. Ensure the key starts with `pk_test_` (for development) or `pk_live_` (for production)\n4. Restart your development server after adding the environment variable\n\n## License\n\nThis project is licensed under the MIT License - see the LICENSE file for details.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnextgengk%2Fgitdocs-ai-powered-readme-generator","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnextgengk%2Fgitdocs-ai-powered-readme-generator","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnextgengk%2Fgitdocs-ai-powered-readme-generator/lists"}