https://github.com/owengretzinger/readme-generator

Generate READMEs and architecture diagrams using AI that understands your codebase
https://github.com/owengretzinger/readme-generator

Last synced: 4 months ago
JSON representation

Generate READMEs and architecture diagrams using AI that understands your codebase

• Host: GitHub
• URL: https://github.com/owengretzinger/readme-generator
• Owner: owengretzinger
• Created: 2025-02-05T19:29:56.000Z (4 months ago)
• Default Branch: main
• Last Pushed: 2025-02-07T02:17:26.000Z (4 months ago)
• Last Synced: 2025-02-07T03:23:10.689Z (4 months ago)
• Language: TypeScript
• Size: 8.02 MB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        


  

    

  


README Generator

  


    Generate READMEs and architecture diagrams using AI that understands your codebase

  



  Table of Contents

  


    


      About The Project

      


        

        
Key Features

      

    

    
Architecture

  


## About The Project

This project was originally built as part of [HackMate](https://github.com/owengretzinger/hackmate) for the GDG Mac-a-Thon 2025, which won 1st overall.

### Key Features

- **AI-Powered README Generation:** Generates README files using AI that understands your codebase.

- **Architecture Diagram Generation:** Creates architecture diagrams to visualize the structure of your project.

- **Integration with Vertex AI:** Leverages Google Cloud Vertex AI for AI-powered features.

- **Next.js Frontend:** Modern and responsive user interface built with Next.js.

- **TRPC API:** Type-safe API communication between frontend and backend.

- **Authentication:** Secure user authentication using NextAuth.js and Google Provider.

## Architecture

- **Frontend:**

  - Next.js (T3 Stack)

  - TypeScript

  - Shadcn UI

  - Tailwind CSS

  - Next-themes for dark/light mode support

- **Backend (Next.js)**

  - tRPC (type-safe communication between frontend and backend)

  - Postgres Database (hosted on Neon)

  - Drizzle ORM with drizzle-kit for migrations

  - Vercel for deployment

- **Repo Packing Service:**

  - Python

  - gitingest

  - Google Cloud Run

## Todo

- [ ] Robust Post Hog capturing

- [ ] Get a domain name

- [ ] Enable diagram generation using DeepSeek R1

- [ ] Login with GitHub

- [ ] Ability to access private repositories