Is attendance-system still maintained?

Slowing down. Last change 6 months ago.

Can I trust attendance-system?

New, little track record. 1 stars, 1 years old. Look at the code and the owner before running it.

gitmanual

Reading the repo

Opening the box…

How to install attendance-system on macOS (yuchen5564/attendance-system) · gitmanual

How to install on macOS

yuchen5564/attendance-system

A modern enterprise attendance management system built with React and Firebase, providing comprehensive employee attendance tracking, leave management, and reporting features.

Node.jsVite

Before you start

Is it free?: YesOpen source (MIT).
Still maintained?: Slowing downLast change 6 months ago.
Can I trust it?: New, little track record1 stars, 1 years old. Look at the code and the owner before running it.

Difficulty: Easy
Time: about 5 min
Stars: ★ 1
Activity: Updated 6 months ago

Fresh setup, read just now

Will it work on macOS?

Yes, it runs on macOS

You'll build it yourself with Node.js.

Your system

macOS Windows Linux

Start here

Website ↗hrsys.merlinkuo.twThe project's own site.

Heads-upIt also needs 7 settings in .env (1 secret).

5 steps on macOS

Download setup.sh

Then run bash setup.sh. It stops at the first error and is safe to run again. Servers and tests aren't started; it lists them at the end. Read it first.

Clone the repository

Needs Git: xcode-select --install

git clone https://github.com/yuchen5564/attendance-system.git
cd attendance-system

Install the required runtimes

Node.js LTS (no version pinned)

# needs nvm: brew install nvm (or https://github.com/nvm-sh/nvm)
nvm install --lts

3
Configure environment variables
Fill in secrets: REACT_APP_FIREBASE_API_KEY
```
cp .env.example .env
```
4
Install dependencies
```
npm ci
```
5
Run it
```
npm run dev
```

From the README: Quick Start

Prerequisites

Node.js 16.0 or higher
npm or yarn package manager
Firebase project account

Installation Steps

Clone the Project

git clone <repository-url>
cd attendance-system

Install Dependencies
```
npm install
```

Environment Variables Setup

Create a .env file in the project root:

VITE_FIREBASE_API_KEY=your_api_key
VITE_FIREBASE_AUTH_DOMAIN=your_project.firebaseapp.com
VITE_FIREBASE_PROJECT_ID=your_project_id
VITE_FIREBASE_STORAGE_BUCKET=your_project.appspot.com
VITE_FIREBASE_MESSAGING_SENDER_ID=your_sender_id
VITE_FIREBASE_APP_ID=your_app_id

Start Development Server
```
npm run dev
```
Open Browser

Visit http://localhost:5173 to start using the system

Did you get it running?

No reports for macOS yet.

Still stuck? Get a written guide

GitManual AI Agent reads the 3 key files and writes a step-by-step guide for macOS. Once written, it's saved for everyone.