Skip to content

Repository files navigation

MarcoHR - Performance Dashboard

A production-ready React dashboard application for HR performance management.

Features

  • 📊 KPI Cards - Visual metrics with growth indicators and mini charts
  • 📈 Spending Analytics - Interactive charts for salary and tax tracking
  • 📋 Project Management - Project table with progress tracking
  • Task Completion - Visual task completion metrics
  • 📱 Responsive Design - Mobile-first, fully responsive layout
  • Accessible - WCAG compliant with ARIA labels and keyboard navigation
  • 🎨 Modern UI - Clean, professional design with smooth animations

Tech Stack

  • React 19 - UI library
  • TypeScript - Type safety
  • Vite - Build tool and dev server
  • Tailwind CSS - Styling
  • Recharts - Chart library
  • Lucide React - Icons
  • Phosphor Icons - Additional icons

Project Structure

marcohr/
├── components/          # React components
│   ├── ui/             # Reusable UI components
│   └── ...             # Feature components
├── data/               # Mock data and constants
├── constants/          # App-wide constants
├── utils/              # Utility functions
├── types.ts            # TypeScript type definitions
└── ...

Getting Started

Prerequisites

  • Node.js 18+ or Bun
  • npm, yarn, pnpm, or bun

Installation

# Install dependencies
npm install

# or with bun
bun install

Development

# Start development server
npm run dev

# or with bun
bun run dev

The app will be available at http://localhost:3000

Build

# Build for production
npm run build

# Preview production build
npm run preview

Production Considerations

Environment Variables

Create a .env file for environment-specific configuration:

VITE_API_URL=https://api.example.com
VITE_APP_NAME=MarcoHR

Performance Optimizations

  • ✅ React.memo for component memoization
  • ✅ useMemo for expensive calculations
  • ✅ Lazy loading for images
  • ✅ Code splitting ready (add React.lazy as needed)

Accessibility

  • ✅ ARIA labels and roles
  • ✅ Keyboard navigation support
  • ✅ Focus management
  • ✅ Screen reader friendly
  • ✅ Semantic HTML

Error Handling

  • ✅ Error boundaries for graceful error handling
  • ✅ Loading states
  • ✅ Empty states
  • ✅ Image error fallbacks

Code Quality

  • TypeScript for type safety
  • ESLint for code linting
  • Consistent code formatting
  • Component composition
  • Separation of concerns

Browser Support

  • Chrome (latest)
  • Firefox (latest)
  • Safari (latest)
  • Edge (latest)

License

Private - All rights reserved

About

Resources

Stars

14 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages