Issuefy

A sleek and simple issue tracker for your project.

       

 See it in Action  »

Introduction · Features · Tech Stack · Development Setup · Contributing

❄️ Introduction

Issuefy is a modern, easy-to-use issue tracker designed to simplify the management of your project’s issues. Whether you're managing bugs, feature requests, or general tasks, Issuefy helps you stay organized and productive. Delve into the codebase to explore more.

🔋  Features

•   ▲   Next.js 15 with Server Actions

•  🚥   Full-featured issue tracking and management

•  📊   Intelligent dashboard with issue metrics

•  🔍   Advanced filtering and sorting capabilities

•  💾   Prisma ORM with PostgreSQL integration

•  🗃️   Organized File and Folder Structure

•  🔑   Credentials & OAuth Providers (Google & GitHub)

•  🔒   Secure Password Reset

•  🥏   TypeScript for Type Safety

•  🐳   Docker Containerization for Consistent Development

•  ☾   Light and Dark Mode Support

⚙️  Tech Stack

• Next.js – React Framework

• Radix UI – Component library

• Tailwind CSS – CSS

• TypeScript - TypeSafe JavaScript

• Zod - Schema Declaration & Validation Library

• Prisma – ORM

• Postgres - Database

• Auth.js – Authentication

• Resend – Email API For Developers

• Git – Versioning

• Vercel – Deployments

🖥️   Local Development

0. Prerequisites
   Make sure you have the following installed on your machine:

   • Git
   • Node.js (v20+)
   • Docker
   • pnpm (Package Manager)

1. Clone the repository:

   git clone https://github.com/yntpdotme/issuefy.git

2. Navigate to the project directory:

   cd issuefy

3. Install dependencies:

   pnpm install

4. Add Environment Variables:

   Create .env file in the root folder and copy paste the content of .env.sample

   cp .env.sample .env

   Update credentials in .env with your credentials.

5. Setup Database

   Start Postgres with Docker

   docker compose up -d

   Setup Prisma

   pnpm prisma generate
   pnpm dlx prisma migrate dev

   Populate the Database:

   pnpm seed

6. Start the App:

   pnpm dev

   Visit  http://localhost:3000  to access your app.

7. Start Prisma Studio:

   pnpm prisma studio

   Visit  http://localhost:5555  to access prisma studio.

🤝  Contributing

Contributions are always welcome!

See CONTRIBUTING.md for ways to get started.

🪪   License

Issuefy is open-source under the MIT License. Feel free to learn, add upon, and share!