Skip to content

JesseJohn7/readify

Repository files navigation

Readify

GitHub stars GitHub forks MIT License

Readify is a web application that enables you to generate production-ready README files directly from your GitHub repositories.

Features

  • Generate README Files: Automatically generates README documentation for your GitHub projects.
  • View Previous Generations: Access and manage previously generated README documents with ease.
  • User Authentication: Secure user sessions managed through Supabase.

Technical Stack

  • Frontend: React, Next.js
  • Styling: Tailwind CSS
  • Backend: Supabase
  • Others: TypeScript

Installation

To get started with Readify, clone the repository and install the dependencies:

git clone https://github.com/JesseJohn7/readify.git
cd readify
npm install

Usage

To run the application in development mode, use the following command:

npm run dev

Visit http://localhost:3000 in your browser to view the app.

Generating a README

The README generation can be accessed through an interface where you can select a GitHub repository. The necessary API calls are handled on the backend, ensuring user authentication through Supabase.

API Endpoints

GET /api/repos
Fetches the user's GitHub repositories (requires authentication).

GET /api/history
Retrieves the history of previously generated README files for the authenticated user.

DELETE /api/history
Deletes a selected README history entry of the authenticated user.

Roadmap

  • Improve UI/UX based on user feedback.
  • Implement additional features for README customization.
  • Support for more markdown elements in the generated READMEs.

License

This project is licensed under the MIT License. See the LICENSE file for details.

Demo

You can view a live demo of Readify at readify-delta.vercel.app.

Contributing

Contributions are welcome! Please submit a pull request for any changes or enhancements.

About

'An Ai Powered Readme Generator that creates comprehensive README files for GitHub projects based on user input and project details.'

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors