{"id":25945985,"url":"https://github.com/muchokidavid/mtaani-fe","last_synced_at":"2025-09-13T13:45:26.145Z","repository":{"id":278733906,"uuid":"936594649","full_name":"MuchokiDavid/mtaani-fe","owner":"MuchokiDavid","description":"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.","archived":false,"fork":false,"pushed_at":"2025-03-18T19:41:52.000Z","size":582,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-09-02T10:42:30.274Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://mtaani-fe.vercel.app","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/MuchokiDavid.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-02-21T10:58:48.000Z","updated_at":"2025-04-28T17:40:38.000Z","dependencies_parsed_at":"2025-02-21T12:25:04.014Z","dependency_job_id":"a23f722c-63e5-4e8f-838d-639597fabc24","html_url":"https://github.com/MuchokiDavid/mtaani-fe","commit_stats":null,"previous_names":["muchokidavid/mtaani-fe"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/MuchokiDavid/mtaani-fe","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MuchokiDavid%2Fmtaani-fe","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MuchokiDavid%2Fmtaani-fe/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MuchokiDavid%2Fmtaani-fe/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MuchokiDavid%2Fmtaani-fe/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/MuchokiDavid","download_url":"https://codeload.github.com/MuchokiDavid/mtaani-fe/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MuchokiDavid%2Fmtaani-fe/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":274971383,"owners_count":25383465,"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","status":"online","status_checked_at":"2025-09-13T02:00:10.085Z","response_time":70,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":[],"created_at":"2025-03-04T09:19:44.262Z","updated_at":"2025-09-13T13:45:26.104Z","avatar_url":"https://github.com/MuchokiDavid.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# MtaaniApp - Property Management System\n\nMtaaniApp 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.\n\n---\n\n## Features\n\n### User Management\n- **Custom User Model**: Supports roles for tenants, landlords, and admins.\n\n### Tenant Management\n- **Tenant Profiles**: Manage tenant details, leases, and payment history.\n- **Room Booking**: Tenants can book available rooms.\n- **Maintenance Requests**: Tenants can submit maintenance requests for their rooms or properties.\n- **Complaints**: Tenants can file complaints regarding property issues.\n- **Feedback**: Tenants can provide feedback on their experience.\n\n### Landlord Management\n- **Property Management**: Add, update, and manage properties with details like name, location, and description.\n- **Room Management**: Manage rooms within properties, including availability and pricing.\n- **Announcements**: Post announcements for tenants (e.g., maintenance schedules, policy updates).\n- **Payment Tracking**: Track payments from tenants for booked rooms or properties.\n\n### Admin Features\n- **Dashboard**: Admin panel to manage users, properties, payments, and system-wide settings.\n- **Notifications**: Send notifications to users for important updates.\n\n---\n\n## Technologies Used\n\n### Frontend\n- **Framework**: React Vite\n- **State Management**: React Context API or Redux (optional)\n- **Styling**: Tailwind CSS or any CSS framework\n- **Routing**: React Router\n- **Data storage** : IndexedDb\n\n---\n\n## Installation\n\n### Frontend Setup (React)\n\n1. **Navigate to the frontend directory**:\n   ```bash\n   cd ../mtaani-fe\n   ```\n\n2. **Install dependencies**:\n   ```bash\n   npm install\n   ```\n\n3. **Run the frontend server**:\n   ```bash\n   npm run dev\n   ```\n   The frontend will be available at `http://localhost:3000`.\n\n---\n\n## Usage\n\n### Tenant Features\n- **Register/Login**: Tenants can register or log in to access their dashboard.\n- **Book a Room**: Browse available rooms and book them.\n- **Submit Maintenance Requests**: Report issues with their room or property.\n- **File Complaints**: Submit complaints regarding property issues.\n- **View Announcements**: Stay updated with announcements from landlords.\n\n### Landlord Features\n- **Register/Login**: Landlords can register or log in to access their dashboard.\n- **Manage Properties**: Add, update, or delete properties.\n- **Manage Rooms**: Add or update rooms within properties.\n- **Post Announcements**: Share updates or notices with tenants.\n\n---\n## Contributing\n\nWe welcome contributions! If you'd like to contribute to MtaaniApp, follow these steps:\n\n1. **Fork the repository**.\n2. **Create a new branch**:\n   ```bash\n   git checkout -b feature-name\n   ```\n3. **Make your changes**.\n4. **Commit your changes**:\n   ```bash\n   git commit -am 'Add new feature'\n   ```\n5. **Push to your branch**:\n   ```bash\n   git push origin feature-name\n   ```\n6. **Create a Pull Request**.\n\n---\n\n## License\n\nThis project is licensed under the **MIT License**. See the [LICENSE](LICENSE) file for details.\n\n---\n\n## Contact\n\nFor questions, suggestions, or support, feel free to reach out:\n\n- **Email**: [dmmuchoki7@gmail.com]\n- **GitHub Issues**: [Open an issue](https://github.com/muchokidavid/mtaani-fe/issues)\n\n---\n\nThank you for using MtaaniApp! We hope it simplifies property management for you. 🏠✨","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmuchokidavid%2Fmtaani-fe","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmuchokidavid%2Fmtaani-fe","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmuchokidavid%2Fmtaani-fe/lists"}