https://github.com/aadhar41/society-services-frontend

A modern, API-first society management ERP built with React 19 and Vite. This frontend provides a premium, claymorphic user experience for managing multi-tenant societies.
https://github.com/aadhar41/society-services-frontend

git github npm react society-management society-services tailwindcss-v4 vite

Last synced: 13 days ago
JSON representation

A modern, API-first society management ERP built with React 19 and Vite. This frontend provides a premium, claymorphic user experience for managing multi-tenant societies.

• Host: GitHub
• URL: https://github.com/aadhar41/society-services-frontend
• Owner: aadhar41
• Created: 2026-03-28T12:49:41.000Z (3 months ago)
• Default Branch: master
• Last Pushed: 2026-04-12T04:14:57.000Z (2 months ago)
• Last Synced: 2026-04-12T06:14:35.020Z (2 months ago)
• Topics: git, github, npm, react, society-management, society-services, tailwindcss-v4, vite
• Language: JavaScript
• Homepage:
• Size: 776 KB
• Stars: 1
• Watchers: 0
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

          
# SAMS Portal (Society Administrative Management System)

A modern, API-first society management ERP built with React 19 and Vite. This frontend provides a premium, claymorphic user experience for managing multi-tenant societies.

## 🚀 Tech Stack

- **Framework**: [React 19](https://react.dev/)

- **Build Tool**: [Vite 8](https://vitejs.dev/)

- **Styling**: [Tailwind CSS 4](https://tailwindcss.com/)

- **Animations**: [Framer Motion](https://www.framer.com/motion/)

- **Icons**: [Lucide React](https://lucide.dev/)

- **Networking**: [Axios](https://axios-http.com/)

- **Routing**: [React Router 7](https://reactrouter.com/)

## ✨ Key Features

- **Claymorphic UI**: High-end aesthetic with soft shadows and glassmorphism.

- **Dynamic Module System**: 12 integrated ERP modules with role-based access control.

- **Society Switching**: Seamlessly manage multiple societies from a single account.

- **API-First**: Built to consume the companion Laravel backend (Society Services API).

## 📸 Admin Panel Screenshots

| User Management | Global Societies |

| :--- | :--- |

| ![User Management](assets/screens/admin_users.png) | ![Global Societies](assets/screens/admin_societies.png) |

| **License Management** | **System Modules** |

| ![License Management](assets/screens/admin_licenses.png) | ![System Modules](assets/screens/admin_modules.png) |

## 🛠️ ERP Modules

1. **Infrastructure**: Manage wings, units, and parking allocations.

2. **Accounting**: Full ledger system with invoices and payment tracking.

3. **Complaints**: Integrated ticketing for resident maintenance requests.

4. **Visitors**: Pre-approvals and real-time check-in logs.

5. **Facility Booking**: Clubhouse and amenity reservation management.

6. **Communication**: System-wide notices, polls, and announcements.

7. **Members**: Centralized resident and owner directory.

8. **Staff & Vendors**: Service provider and employee management.

9. **Documents**: Secure storage for society bylaws and certificates.

10. **Meetings**: Schedule and record minutes for general body meetings.

11. **Asset Management**: Inventory and maintenance of society property.

12. **Parking**: Vehicle tag management and slot tracking.

## 🛠️ Development

### Prerequisites

- Node.js (Latest LTS)

- NPM or PNPM

### Installation

```bash

npm install

```

### Running Locally

```bash

npm run dev

```

### Building for Production

```bash

npm run build

```