Skip to content

pesanio/pesan-pms

Repository files navigation

Pesan PMS Logo

License: MIT Next.js React Bun PRs welcome

Pesan PMS is an open-source property management system designed to help manage hotels, homestays, villas, and other accommodation properties.

Pesan PMS Dashboard

Features

  • Dashboard Overview: Get a quick glance at your property's performance
  • Booking Management: Handle reservations, check-ins, and check-outs
  • Guest Management: Store and manage guest information
  • Room/Unit Management: Track room availability and maintenance
  • Staff Management: Manage staff schedules and permissions
  • Reporting: Generate financial and occupancy reports
  • Multi-property Support: Manage multiple properties from a single dashboard
  • Responsive Design: Works on desktop, tablet, and mobile devices

Roadmap

  • Authentication system
  • Dashboard UI with charts and reports
  • Property setup wizard
  • Room/unit inventory management
  • Booking calendar
  • Guest profiles
  • Invoicing and payments
  • Housekeeping management
  • Maintenance tracking
  • Channel manager integration
  • API for third-party integrations
  • Mobile app
  • Multi-language support
  • Dark mode

Getting Started

There are two ways to use Pesan PMS:

  1. Self-host the application
  2. Contribute to the project development

How to Self-Host

Option 1: Using Bun (Recommended)

# Clone the repository
git clone https://github.com/yourusername/pesan-pms.git
cd pesan-pms

# Install dependencies
bun install

# Create environment file
cp .example.env .env

# Start the development server
bun run dev

After running these commands:

  1. Access the Application:

    • Open http://localhost:3000 in your browser
    • The application should be running with hot-reloading enabled
  2. Building for Production:

    # Build the application
    bun run build
    
    # Start the production server
    bun run start

Option 2: Using Docker

# Clone the repository
git clone https://github.com/yourusername/pesan-pms.git
cd pesan-pms

# Create a .env file for Docker (or use the provided example)
cp .env.docker .env

# Build and start the Docker container
docker-compose up -d

# Access the application at http://localhost:3000

The Docker setup will:

  • Build the application in a container
  • Store the SQLite database in a persistent volume
  • Run the application on port 3000

Contributing

We welcome contributions! Please see our Contributing Guide for details.

Tech Stack

License

This project is licensed under the MIT License - see the LICENSE file for details.

Acknowledgments

  • shadcn/ui for the beautiful UI components
  • Radix UI for accessible UI primitives
  • Tailwind CSS for the utility-first CSS framework
  • Next.js for the React framework
  • Better Auth for the authentication system
  • Bun for the JavaScript runtime and package manager

Made with ❤️ by the Pesan PMS team

About

Open Source Property Management System (PMS) from Pesan.io

Topics

Resources

License

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages