Documentation Index
Fetch the complete documentation index at: https://mintlify.com/Rampop01/HR-Platform/llms.txt
Use this file to discover all available pages before exploring further.
Introduction to HCMatrix
HCMatrix is a comprehensive SaaS HR management platform designed to streamline workforce operations for modern organizations. Built with cutting-edge technologies, it provides powerful tools for managing employees, tracking attendance, handling recruitment, and generating insightful reports.What is HCMatrix?
HCMatrix is a full-featured HR management system that helps organizations:- Manage Employee Data: Centralize all employee information with searchable, paginated employee directories
- Track Workforce Metrics: Monitor headcount, new hires, attendance, and department distribution in real-time
- Streamline Recruitment: Manage open positions and track candidates throughout the hiring process
- Monitor Attendance: Track employee presence, remote work, and leave status
- Generate Reports: Create data-driven insights about your workforce
- Manage Payroll: Handle compensation and benefits administration
- Document Management: Store and organize important HR documents
- Calendar Integration: Track events, birthdays, anniversaries, and important dates
Key Features
Employee Management
Comprehensive employee profiles with personal information, job details, tenure tracking, and more. Search and filter across your entire workforce.
Real-Time Dashboard
Visual insights with headcount growth charts, department distribution, attendance metrics, and action items.
Authentication & Security
Secure token-based authentication with localStorage session management and protected routes.
Modern UI Components
Built with Radix UI and Tailwind CSS for a polished, accessible user experience.
Architecture Overview
HCMatrix follows a modern Next.js architecture with the following structure:Tech Stack
- Framework: Next.js 16.1.6 with App Router
- UI Library: React 19.2.4
- Language: TypeScript 5.7.3
- Styling: Tailwind CSS 4.2.0
- UI Components: Radix UI primitives
- Charts: Recharts 2.15.0
- Icons: Lucide React
- Form Handling: React Hook Form with Zod validation
- Analytics: Vercel Analytics
Project Structure
Authentication Flow
HCMatrix uses a token-based authentication system:- User logs in with email and password
- API returns JWT token and user data
- Session stored in localStorage
- Token sent with all subsequent API requests
- Automatic redirect to login if unauthenticated
lib/auth.ts:1:
API Integration
The platform uses a centralized API client that proxies requests through Next.js API routes to avoid CORS issues. All API calls are typed with TypeScript interfaces. Fromlib/api.ts:64:
What You Can Build
With HCMatrix, you can:Deploy a complete HR system
Launch a full-featured HR management platform for your organization with minimal configuration.
Customize workflows
Extend the platform with custom modules for your specific HR processes and policies.
Integrate with existing systems
Connect HCMatrix to your payroll providers, benefits platforms, and other HR tools.
Browser Support
HCMatrix supports all modern browsers:- Chrome (latest)
- Firefox (latest)
- Safari (latest)
- Edge (latest)
Next Steps
Quickstart
Get HCMatrix running in under 5 minutes
Installation
Detailed setup and configuration guide
