Skip to content

gauravxdev/Trackr

Repository files navigation

Trackr - Modern Project Management Solution

Trackr Logo

Streamline Your Workflow with Trackr

🚀 Overview

Trackr is a powerful, intuitive project management application designed to help teams collaborate effectively and deliver projects on time. With its modern UI and comprehensive feature set, Trackr provides everything you need to manage projects from inception to completion.

✨ Features

📋 Project Management

  • Project Creation & Organization: Create and organize projects with custom keys and descriptions
  • Organization Management: Manage projects across different organizations
  • Role-Based Access Control: Admin and member roles with appropriate permissions

🏃‍♂️ Sprint Planning

  • Sprint Creation: Plan work in time-boxed sprints
  • Sprint Status Management: Track sprint progress (Planned, Active, Completed)
  • Sprint Boards: Visualize sprint work in an intuitive interface

📊 Issue Tracking

  • Kanban Boards: Visualize workflow with customizable boards
  • Drag & Drop Interface: Easily move issues between statuses
  • Issue Prioritization: Set priorities (Low, Medium, High, Urgent)
  • Issue Assignment: Assign issues to team members

👥 Team Collaboration

  • User Management: Invite and manage team members
  • Organization Switching: Work across multiple organizations
  • User Dashboards: View assigned issues and project status

🔒 Authentication & Security

  • Secure Authentication: Powered by Clerk for robust user management
  • Protected Routes: Secure access to sensitive areas of the application

🛠️ Tech Stack

  • Frontend: Next.js 15, React 18, TailwindCSS
  • UI Components: Shadcn UI, Radix UI primitives
  • State Management: React Hooks
  • Forms: React Hook Form with Zod validation
  • Database: PostgreSQL with Prisma ORM
  • Authentication: Clerk
  • Styling: TailwindCSS with custom animations
  • Drag & Drop: Hello Pangea DnD (React Beautiful DnD fork)

📦 Installation

Prerequisites

  • Node.js 18+ and npm/yarn
  • PostgreSQL database (or use a service like Neon.tech)
  • Clerk account for authentication

Setup Instructions

  1. Clone the repository

    git clone https://github.com/yourusername/trackr.git
    cd trackr
  2. Install dependencies

    npm install
    # or
    yarn install
  3. Set up environment variables Create a .env file in the root directory with the following variables:

    # Database
    DATABASE_URL="postgresql://username:password@localhost:5432/trackr?schema=public"
    
    # Clerk Authentication
    CLERK_SECRET_KEY=your_clerk_secret_key
    NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY=your_clerk_publishable_key
    NEXT_PUBLIC_CLERK_SIGN_IN_URL=/sign-in
    NEXT_PUBLIC_CLERK_SIGN_UP_URL=/sign-up
    NEXT_PUBLIC_CLERK_AFTER_SIGN_IN_URL=/onboarding
    NEXT_PUBLIC_CLERK_AFTER_SIGN_UP_URL=/onboarding
  4. Set up the database

    npx prisma migrate dev --name init
  5. Run the development server

    npm run dev
    # or
    yarn dev
  6. Open your browser Visit http://localhost:3000 to see the application in action.

🚀 Deployment

Trackr can be easily deployed to platforms like Vercel or Netlify:

  1. Connect your repository to Vercel/Netlify
  2. Configure the environment variables
  3. Deploy!

📝 Project Structure

/
├── app/                  # Next.js app directory
│   ├── (auth)/           # Authentication routes
│   ├── (main)/           # Main application routes
│   │   ├── organization/ # Organization management
│   │   ├── project/      # Project management
│   │   └── onboarding/   # User onboarding
│   └── api/              # API routes
├── components/           # Reusable components
├── lib/                  # Utility functions and libraries
├── prisma/               # Database schema and migrations
├── public/               # Static assets
└── styles/               # Global styles

🧪 Testing

Run the test suite with:

npm test
# or
yarn test

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

  1. Fork the repository
  2. Create your feature branch (git checkout -b feature/amazing-feature)
  3. Commit your changes (git commit -m 'Add some amazing feature')
  4. Push to the branch (git push origin feature/amazing-feature)
  5. Open a Pull Request

📄 License

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

👨‍💻 Author

Made with 💗 by Gaurav Sharma


Ready to transform your workflow? Try Trackr today!

About

Project Management App

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published