Welcome to the lumina-staff-suite-frontend wiki!

Welcome to the Lumina Staff Suite Frontend Wiki 🚀

Lumina Staff Suite is a modern, enterprise-grade Single Page Application (SPA) designed to provide a seamless Human Resource Management experience. This frontend is built with performance, scalability, and maintainability in mind.

🛠 Core Technology Stack

• Framework: React 19 (bootstrapped with Vite for instant server start)
• Language: TypeScript (Strict mode enabled for 100% type safety)
• Styling: Tailwind CSS (Utility-first approach with Dark Mode support)
• Routing: React Router v6
• Internationalization: i18next (Multi-language support)

📁 Project Structure

We follow a feature-based folder architecture. Instead of grouping files by type (e.g., all components together, all hooks together), we group them by business feature:

src/
 ├── assets/        # Static files (images, icons)
 ├── common/        # Shared interfaces and types (synced with Backend)
 ├── components/    # Global reusable UI components (Buttons, Modals)
 ├── features/      # Feature-specific modules (Auth, Dashboard, Employees)
 ├── hooks/         # Global custom React Hooks
 ├── services/      # API client wrappers and endpoint definitions
 └── utils/         # Helper functions and formatters