mirror of https://github.com/rjNemo/rentease.git synced 2026-06-06 02:36:49 +00:00

Property management app

Find a file

Ruidy cf7e1d4cb6 fix: parsing item name		2025-01-07 22:28:57 +01:00
.github/workflows	fix: dependencies	2024-12-08 17:45:47 +01:00
assets	remove unused css	2024-08-23 16:24:24 +02:00
cmd/cron	clean the cron job	2024-12-07 12:49:05 +01:00
docs	improve layout	2024-11-25 14:58:18 +01:00
internal	fix: parsing item name	2025-01-07 22:28:57 +01:00
pkg/time	use std lib for time formatting	2024-04-12 17:31:24 +02:00
.air.toml	use docker dev env	2024-08-09 15:33:33 +02:00
.gitignore	update dependencies	2024-12-07 12:31:51 +01:00
Dockerfile	Create taxes for taxable items automatically (#16 )	2024-08-26 21:44:31 +02:00
Dockerfile.dev	cleanup	2024-08-23 08:21:22 +02:00
go.mod	parsing (#28 )	2025-01-05 16:04:44 +01:00
go.sum	parsing (#28 )	2025-01-05 16:04:44 +01:00
justfile	feat: Add justfile to replace Makefile with Just task runner	2024-12-08 12:08:54 +01:00
main.go	chore: upgrade dependencies	2025-01-04 13:19:01 +01:00
README.md	fix: the card total reporting	2024-12-24 18:13:19 +01:00

README.md

Rentease

Rentease

Rentease is a property-management application to help landlords to manage your rental properties efficiently. With Rentease, you can create invoices, generate activity reports, and sync all the booking platforms you use.

Features

Invoice Management: Create and manage invoices for your rental properties with ease.
Activity Reports: Generate detailed reports of rental activities to keep track of your property performance.
Platform Sync: Sync bookings across multiple platforms to streamline your rental management.

![RentEase Screenshot][product-screenshot]

Getting Started

To get started with Rentease, follow these steps.

Prerequisites

You need a version of the Go programming language installed. You can either install it via your package manager or via Go's official website. You also need a PostgreSQL database. You can install it locally using Homebrew or use a cloud alternative such as Railway, fly.io, etc.

Installation

Clone the repository

git clone https://github.com/rjNemo/rentease.git
cd rentease

Install the dependencies
```
go mod download
```
Setup PostgreSQL: Ensure you have PostgreSQL installed and running. Create a database for Rentease:
```
createdb rentease
```

Configure the application: Create a .env file in the project root with the following environment variables:

DB_HOST=localhost
DB_PORT=5432
DB_USER=your_db_username
DB_PASSWORD=your_db_password
DB_NAME=rentease

Start the application
```
make dev
```
Access the application: Open your browser and go to http://localhost:8000 to start using Rentease.

Built With

Rentease is built using the following technologies:

Go: The core application logic is written in Go, providing a robust and efficient backend.
Htmx: For handling AJAX requests and enhancing the user interface with minimal JavaScript.
Templ: Used for templating and rendering dynamic HTML content.
Gorm: An ORM library for Go, used for database interactions.
PostgreSQL:The database used to store all application data.

Roadmap

See the open issues for a full list of proposed features (and known issues).

Contributing

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement".

Don't forget to give the project a star! Thanks again!

Fork the Project
Create your Feature Branch (git checkout -b feature/AmazingFeature)
Commit your Changes (git commit -m 'Add some AmazingFeature')
Push to the Branch (git push origin feature/AmazingFeature)
Open a Pull Request

License

Distributed under the MIT License. See LICENSE.md for more information.