{"id":25304475,"url":"https://github.com/nodeninjar/nexus-tech-client","last_synced_at":"2025-04-07T03:55:01.327Z","repository":{"id":275817798,"uuid":"926060509","full_name":"nodeNINJAr/nexus-tech-client","owner":"nodeNINJAr","description":"Nexus Tech is a comprehensive **Employee Management System** (EMS) designed to manage employees, HR, and administrative operations efficiently. The platform ensures seamless workflows, secure role-based access, and robust data management for businesses.","archived":false,"fork":false,"pushed_at":"2025-02-04T18:02:57.000Z","size":385,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-02-13T08:41:57.143Z","etag":null,"topics":["employee-management","employee-management-system","multi-funcional"],"latest_commit_sha":null,"homepage":"https://nexustech-b3673.web.app/","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/nodeNINJAr.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-02-02T13:07:58.000Z","updated_at":"2025-02-04T18:04:01.000Z","dependencies_parsed_at":"2025-02-04T19:19:11.886Z","dependency_job_id":"1aa4d713-99d8-4322-8e34-f9e5c43cae24","html_url":"https://github.com/nodeNINJAr/nexus-tech-client","commit_stats":null,"previous_names":["nodeninjar/nexus-tech-client"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nodeNINJAr%2Fnexus-tech-client","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nodeNINJAr%2Fnexus-tech-client/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nodeNINJAr%2Fnexus-tech-client/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nodeNINJAr%2Fnexus-tech-client/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/nodeNINJAr","download_url":"https://codeload.github.com/nodeNINJAr/nexus-tech-client/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247589831,"owners_count":20963022,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["employee-management","employee-management-system","multi-funcional"],"created_at":"2025-02-13T08:29:40.646Z","updated_at":"2025-04-07T03:55:01.299Z","avatar_url":"https://github.com/nodeNINJAr.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\n\n---\n\n# **Nexus Tech – Employee Management System**  \n\n![Nexus Tech](https://your-logo-url.com/logo.png)  \n\n## 🚀 Introduction  \n\n**Nexus Tech** is a comprehensive **Employee Management System (EMS)** designed to streamline HR and administrative operations. The platform enables businesses to manage employees efficiently while ensuring:  \n\n- ✅ **Seamless Workflows**  \n- ✅ **Secure Role-Based Access Control**  \n- ✅ **Robust Data Management**  \n\nThis application provides powerful tools to manage employee records, track performance, handle payroll, and facilitate smooth communication within an organization.  \n\n---\n\n## 📑 Table of Contents  \n\n- [**Nexus Tech – Employee Management System**](#nexus-tech--employee-management-system)\n  - [🚀 Introduction](#-introduction)\n  - [📑 Table of Contents](#-table-of-contents)\n  - [Website Details](#website-details)\n  - [🌟 Features](#-features)\n  - [🛠 Tech Stack](#-tech-stack)\n  - [📥 Installation](#-installation)\n    - [**Prerequisites**](#prerequisites)\n    - [**Steps**](#steps)\n  - [▶️ Usage](#️-usage)\n  - [📜 Available Scripts](#-available-scripts)\n  - [⚙️ Environment Variables](#️-environment-variables)\n    - [**Firebase Configuration**](#firebase-configuration)\n  - [🛠 Troubleshooting](#-troubleshooting)\n  - [🤝 Contributing](#-contributing)\n\n---\n\n## Website Details\n\n- **Website Name**: Nexus Tech\n- **Admin Email**: suzume99@gmail.com \n- **Admin Password**: Pa$$w0rd! \n- **Live Site URL Firebase**: [https://nexustech-b3673.web.app](https://nexustech-b3673.web.app)\n- **Live Site URL Netlify**: [https://nexustechweb.netlify.app](https://nexustechweb.netlify.app)\n## 🌟 Features  \n\n✅ **Employee Records Management** – Store and manage employee details securely.  \n✅ **Role-Based Access Control (RBAC)** – Assign different access levels to employees, HR, and admins.  \n✅ **Real-Time Data Sync** – Uses Firebase for authentication and database management.  \n✅ **Payroll \u0026 Attendance Tracking** – Keep records of attendance, leaves, and payroll.  \n✅ **Advanced Search \u0026 Filters** – Easily find employees with powerful search tools.  \n✅ **Modern UI** – Designed with Ant Design and Tailwind CSS for an intuitive user experience.  \n✅ **Interactive Dashboards** – Visualize employee performance and company statistics with Recharts.  \n✅ **Secure API Requests** – Uses Axios to handle secure data communication.  \n\n---\n\n## 🛠 Tech Stack  \n\n| Technology  | Purpose |\n|-------------|---------|\n| **React**   | Frontend Framework |\n| **Vite**    | Development \u0026 Build Tool |\n| **Ant Design** | UI Components |\n| **Tailwind CSS** | Styling |\n| **React Query** | State Management |\n| **React Router** | Navigation |\n| **Axios** | API Communication |\n| **Firebase** | Authentication \u0026 Realtime Database |\n| **Recharts** | Data Visualization |\n| **ImageBB API** | Image Uploading |\n\n---\n\n## 📥 Installation  \n\n### **Prerequisites**  \n\n- **Node.js (\u003e=16.0.0)**  \n- **npm or yarn package manager**  \n\n### **Steps**  \n\n1. Clone the repository:  \n   ```sh\n   git clone https://github.com/nodeNINJAr/nexus-tech-client\n   cd nexus-tech-client\n   ```  \n2. Install dependencies:  \n   ```sh\n   npm install\n   ```  \n3. Start the development server:  \n   ```sh\n   npm run dev\n   ```  \n\n---\n\n## ▶️ Usage  \n\n- Run `npm run dev` to start the local development server.  \n- Use `npm run build` to create an optimized production build.  \n- Run `npm run preview` to preview the production build locally.  \n- Use `npm run lint` to check for coding style issues.  \n\n---\n\n## 📜 Available Scripts  \n\n| Command | Description |\n|---------|-------------|\n| `npm run dev` | Start development server |\n| `npm run build` | Build for production |\n| `npm run preview` | Preview the production build |\n| `npm run lint` | Run ESLint for code quality |\n\n---\n\n## ⚙️ Environment Variables  \n\nCreate a `.env` file in the root directory and configure the required environment variables:  \n\n```env\nVITE_apiKey=your-firebase-api-key\nVITE_authDomain=your-firebase-auth-domain\nVITE_projectId=your-firebase-project-id\nVITE_storageBucket=your-firebase-storage-bucket\nVITE_messagingSenderId=your-firebase-messaging-sender-id\nVITE_appId=your-firebase-app-id\nVITE_base_url=your-backend-api-url\nVITE_imagebb_api_key=your-imagebb-api-key\n```\n\n### **Firebase Configuration**  \nThe Firebase config should be set up as follows in your project:  \n\n```js\nconst firebaseConfig = {\n  apiKey: import.meta.env.VITE_apiKey, \n  authDomain: import.meta.env.VITE_authDomain,\n  projectId: import.meta.env.VITE_projectId, \n  storageBucket: import.meta.env.VITE_storageBucket,\n  messagingSenderId: import.meta.env.VITE_messagingSenderId,\n  appId: import.meta.env.VITE_appId, \n};\n```\n\nFor detailed Firebase setup, refer to [Firebase Docs](https://firebase.google.com/docs).\n\n---\n\n## 🛠 Troubleshooting  \n\n- **Port Conflicts?**  \n  Change the port by running:  \n  ```sh\n  vite --port 3001\n  ```  \n- **Dependency Issues?**  \n  Delete `node_modules` and reinstall:  \n  ```sh\n  rm -rf node_modules package-lock.json \u0026\u0026 npm install\n  ```  \n- **Environment Variables Not Loading?**  \n  Ensure that your `.env` file is correctly formatted and included in `.gitignore`.  \n\n---\n\n## 🤝 Contributing  \n\nWe welcome contributions! Follow these steps:  \n\n1. Fork the repository  \n2. Create a feature branch (`git checkout -b feature-branch`)  \n3. Commit your changes (`git commit -m \"Add new feature\"`)  \n4. Push to the branch (`git push origin feature-branch`)  \n5. Open a Pull Request  \n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnodeninjar%2Fnexus-tech-client","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnodeninjar%2Fnexus-tech-client","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnodeninjar%2Fnexus-tech-client/lists"}