MtaaniApp is a comprehensive property management system built with React for the frontend. It is designed to streamline property management for landlords and tenants, offering features like tenant and landlord management, property and room management, maintenance requests, complaints, announcements, and more.
- Custom User Model: Supports roles for tenants, landlords, and admins.
- Tenant Profiles: Manage tenant details, leases, and payment history.
- Room Booking: Tenants can book available rooms.
- Maintenance Requests: Tenants can submit maintenance requests for their rooms or properties.
- Complaints: Tenants can file complaints regarding property issues.
- Feedback: Tenants can provide feedback on their experience.
- Property Management: Add, update, and manage properties with details like name, location, and description.
- Room Management: Manage rooms within properties, including availability and pricing.
- Announcements: Post announcements for tenants (e.g., maintenance schedules, policy updates).
- Payment Tracking: Track payments from tenants for booked rooms or properties.
- Dashboard: Admin panel to manage users, properties, payments, and system-wide settings.
- Notifications: Send notifications to users for important updates.
- Framework: React Vite
- State Management: React Context API or Redux (optional)
- Styling: Tailwind CSS or any CSS framework
- Routing: React Router
- Data storage : IndexedDb
-
Navigate to the frontend directory:
cd ../mtaani-fe -
Install dependencies:
npm install
-
Run the frontend server:
npm run dev
The frontend will be available at
http://localhost:3000.
- Register/Login: Tenants can register or log in to access their dashboard.
- Book a Room: Browse available rooms and book them.
- Submit Maintenance Requests: Report issues with their room or property.
- File Complaints: Submit complaints regarding property issues.
- View Announcements: Stay updated with announcements from landlords.
- Register/Login: Landlords can register or log in to access their dashboard.
- Manage Properties: Add, update, or delete properties.
- Manage Rooms: Add or update rooms within properties.
- Post Announcements: Share updates or notices with tenants.
We welcome contributions! If you'd like to contribute to MtaaniApp, follow these steps:
- Fork the repository.
- Create a new branch:
git checkout -b feature-name
- Make your changes.
- Commit your changes:
git commit -am 'Add new feature' - Push to your branch:
git push origin feature-name
- Create a Pull Request.
This project is licensed under the MIT License. See the LICENSE file for details.
For questions, suggestions, or support, feel free to reach out:
- Email: [[email protected]]
- GitHub Issues: Open an issue
Thank you for using MtaaniApp! We hope it simplifies property management for you. 🏠✨