Cronix

A Modern, Fast, and Private Attendance Management System

Designed & Developed by Wasim Aouine

---

📖 Overview

Cronix is a blazing-fast, single-page React application built specifically for educators and administrators to manage student attendance natively. Unlike clunky web platforms, Cronix features a stunning Apple-style glassmorphic iOS interface and stores all its data entirely locally in your browser to prioritize privacy and speed. No accounts, no backend servers. Just open it and start tracking.

✨ Features

• Glassmorphic UI: Beautiful, interactive, and responsive interface featuring deep blurs and a vibrant color palette designed for maximum legibility.
• Daily Attendance Sheets: Fast segmented controls to click through and mark students as present or absent for any specific calendar date.
• Student Directory & Bulk Import: Add students manually or use the integrated AI CSV Import Flow to instantly ingest entire lists of students from pictures using AI platforms like ChatGPT.
• Deep Analytics: Visually track total absences, percentages, and precisely which days students missed.
• Participation Tracking: Track daily participation points per student. The system automatically sums total points across all days and applies your custom step values before exporting to Excel.
• Excel Export: Generate perfectly styled, downloadable .xlsx Excel spreadsheets of the attendance and participation logs, filterable by Group, Field, or Section.
• 100% Local: Works offline after initial load. Your student data never leaves your device.

🚀 Getting Started

Prerequisites

Make sure you have Node.js installed on your machine.

Installation

1. Clone the repository:

   git clone https://github.com/yourusername/Cronix.git
   cd Cronix

2. Install dependencies: Cronix relies on minimal external modules (lucide-react for icons and exceljs/file-saver for exports).

   npm install

3. Run the development server:

   npm run dev -- --host

4. Open the app: Open your browser and navigate to http://localhost:5173.

   (If you want to use the app on your phone while walking around the classroom, connect your phone to the same Wi-Fi network and scan the Network IP address provided in your terminal!)

💡 How to use the "AI Import"

Typing names is slow. Cronix includes an AI-assisted bulk import:

1. Take a picture of your physical attendance sheet.
2. Go to the Student Directory in Cronix and click the AI Import Flow button.
3. Copy the provided prompt and send it to an AI along with your image.
4. Save the returning CSV text to a file, and click Import CSV in Cronix to instantly populate your dashboard.

🛠 Built With

• React 18
• Vite
• Tailwind CSS v4
• ExcelJS
• Lucide Icons

📄 License

Created by Wasim Aouine & Rami Bouricha. © 2026. All Rights Reserved.