TickHawk is your go-to solution for managing tickets and issues efficiently. Designed for businesses that prioritize organization and collaboration, TickHawk empowers teams to resolve tasks swiftly and effectively.
"Stay sharp. Stay organized. Let TickHawk handle the chaos." 🦅
Warning
Disclaimer
This project is still in development and contains bugs 🐛, as well as several unfinished features 🚧.
- Role-based permissions system with admin, agent, and customer roles
- Department organization within companies
- Create, assign, track, and resolve tickets
- Priority levels: Low, Medium, High, Critical
- Status tracking: Open, In Progress, Resolved, Closed, Pending
- Comment system with file attachments
- Internal notes for agents and admins (invisible to customers)
- Event history for all ticket changes
- Upload and download file attachments
- Multiple storage provider options:
- Local file system
- AWS S3
- MinIO
- OVH Object Storage
- Comprehensive profile management
- Role assignment
- Company and department association
- View tickets and metrics by date ranges
- Customer and agent reporting views
- Backend: NestJS, MongoDB, TypeScript
- Frontend: React, Tailwind CSS, TypeScript
- Containerization: Docker, Docker Compose
- Tooling: Turborepo
- Node.js (v18+)
- MongoDB
- Docker and Docker Compose (for containerized deployment)
- Clone the repository
- Install dependencies:
npm install - Configure environment variables (see API and App README files for details)
- Start development servers:
npm run start
- Simply run:
docker compose up -d - Access the application at http://localhost
- /api - NestJS backend application
- /app - React frontend application
- /doc - Documentation files
See the README files in the /api and /app directories for detailed environment configuration options.
We welcome contributions! Please feel free to submit a Pull Request.