{"id":24529165,"url":"https://github.com/haxcod/homerent","last_synced_at":"2025-03-15T17:45:44.015Z","repository":{"id":256002423,"uuid":"854073696","full_name":"haxcod/HomeRent","owner":"haxcod","description":null,"archived":false,"fork":false,"pushed_at":"2024-09-15T15:45:23.000Z","size":267,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-01-22T07:37:43.348Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://home-rent-ten.vercel.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/haxcod.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":"2024-09-08T10:43:39.000Z","updated_at":"2024-09-15T15:45:26.000Z","dependencies_parsed_at":"2024-09-12T20:41:55.181Z","dependency_job_id":"92e0bb83-26c6-4d93-8992-1317a71e318e","html_url":"https://github.com/haxcod/HomeRent","commit_stats":null,"previous_names":["iamashishrathaur/homerent","haxcod/homerent"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/haxcod%2FHomeRent","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/haxcod%2FHomeRent/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/haxcod%2FHomeRent/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/haxcod%2FHomeRent/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/haxcod","download_url":"https://codeload.github.com/haxcod/HomeRent/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243769949,"owners_count":20345215,"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":[],"created_at":"2025-01-22T07:35:01.288Z","updated_at":"2025-03-15T17:45:43.975Z","avatar_url":"https://github.com/haxcod.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Room Rent Management System\n\n## Overview\n\nThe Room Rent Management System is a web application designed to help landlords and tenants manage room rentals efficiently. This application allows landlords to list available rooms, manage tenant information, track rental payments, and more. Tenants can view available rooms, make rental payments, and track their rental history.\n\n## Features\n\n- **Room Listings**: Landlords can add, update, and delete room listings.\n- **Tenant Management**: Manage tenant details, including personal information and rental agreements.\n- **Payment Tracking**: Track rental payments, including amounts due, paid, and overdue.\n- **Search and Filter**: Search and filter rooms based on various criteria.\n- **Dashboard**: View an overview of room occupancy, rental income, and pending payments.\n\n## Installation\n\nTo set up the Room Rent Management System locally, follow these steps:\n\n1. **Clone the Repository**:\n   ```sh\n   git clone https://github.com/iamashishrathur/HomeRent.git\n   ```\n\n2. **Navigate to the Project Directory**:\n   ```sh\n   cd HomeRent\n   ```\n\n3. **Install Dependencies**:\n   For the backend:\n   ```sh\n   cd backend\n   npm install\n   ```\n\n   For the frontend:\n   ```sh\n   cd ../frontend\n   npm install\n   ```\n\n4. **Setup Environment Variables**:\n   Create a `.env` file in the `backend` directory and add the necessary environment variables:\n   ```\n   DB_HOST=localhost\n   DB_USER=your-database-user\n   DB_PASSWORD=your-database-password\n   DB_NAME=room_rent_management\n   ```\n\n5. **Run Migrations**:\n   Run database migrations to set up the initial schema:\n   ```sh\n   cd backend\n   npm run migrate\n   ```\n\n6. **Start the Application**:\n   Start the backend server:\n   ```sh\n   npm start\n   ```\n\n   In another terminal, start the frontend development server:\n   ```sh\n   cd frontend\n   npm start\n   ```\n\n## Usage\n\n1. **Access the Application**:\n   Open your browser and go to `http://localhost:3000` to access the Room Rent Management System.\n\n2. **Landlord Features**:\n   - **Add Room**: Navigate to the \"Rooms\" section and click \"Add Room\" to create a new room listing.\n   - **Manage Tenants**: Go to the \"Tenants\" section to add or update tenant information.\n   - **Track Payments**: View and manage payment records in the \"Payments\" section.\n\n3. **Tenant Features**:\n   - **View Rooms**: Browse available rooms and view details.\n   - **Make Payments**: Pay rent through the \"Payments\" section.\n   - **View Rental History**: Check your rental history and payment status.\n\n## API Documentation\n\nFor detailed API documentation, refer to the [API Documentation](docs/API.md) file.\n\n## Configuration\n\nThe Room Rent Management System includes configuration files for both the backend and frontend. Customize these files according to your environment and preferences.\n\n## License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n## Contact\n\nFor any questions or feedback, please contact [ashishrathaur3523@gmail.com](mailto:ashishrathaur3523@gmail.com).\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhaxcod%2Fhomerent","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhaxcod%2Fhomerent","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhaxcod%2Fhomerent/lists"}