/HOF-git-trace

Git-Trace: Instantly search, view, and bookmark GitHub repositories and issues. Streamline your workflow and keep your favorite projects at your fingertips!

Primary LanguageTypeScriptMIT LicenseMIT

Git-trace

Open Source save issues and repositories endpoint
git-trace.vercel.com

Git-trace is a tool for viewing, and bookmarking gitHub repositories and issues effortlessly keep track of your projects with ease!

Featured In

Event Logo Event Name Event Description
GSSoC Ext 24 GirlScript Summer of Code Ext 2024 GSSOC Ext is a one-month-long open-source program by the GirlScript Foundation that runs from October 1 to November 10, 2024
Hacktoberfest 24 Hacktoberfest 2024 Hacktober Fest is an annual celebration of open-source software development. It's a month-long event encouraging developers to contribute to open-source projects.

Features

git-Trace allows you to:
Search Repositories: Quickly find GitHub repositories by owner and name.
View Issues: Explore and view issues related to the repositories you’re interested in.
Bookmark Items: Save repositories and issues for quick access, ensuring you never lose track of important projects.

Installation Guide

Before you begin, ensure you have the following prerequisites installed on your local machine:

  • Node.js: Version 14 or higher
  • npm (Node Package Manager): Usually comes with Node.js installation

Follow these instructions to set up Git-trace on your local machine for development or testing purposes:

  1. Clone the repository:
    Download a copy of the project to your local computer.

       git clone https://github.com/rahulsainlll/git-trace.git
       cd git-trace
  2. Install dependencies:

    Install all the necessary libraries and packages.

        npm install
  3. Set up environment variables:

    Copy the provided example .env file and fill in the necessary values.

        cp .env.example .env
  4. Run the development server:

    Start the development server.

        npm run dev
  5. Build the project: (optional)

    Prepare the project for production.

        npx next build
  6. Explore and Test: (optional)

    After following these steps, you can start exploring the app at http://localhost:3000. For more in-depth contribution or development guidelines, please refer to the CONTRIBUTING.md file.

Frontend

The frontend is built with Next.js and React, providing a seamless user experience. It features a clean and intuitive interface for searching repositories and viewing issues, with responsive design (under construction).

Backend

Git-Trace’s backend handles repository and issue searches through gitHub’s api, and supports user authentication for bookmarking features. The system is powered by prisma and neon db for robust data management.

Contributing

Please read through our contributing guide before starting any work.

Star History

Star History Chart

Contributors