Skip to content
/ calm Public

Capable and Accessible Laundry Manager (CALM) is a web-based application for managing laundry facilities in rental properties.

License

Notifications You must be signed in to change notification settings

HE-Arc/calm

Repository files navigation

Contributors Forks Stargazers Issues MIT License


Logo

CALM

Capable and Accessible Laundry Manager (CALM) is a web application for the management of laundry facilities in rental buildings. It offers features such as monetary management, hourly planning, and reservation management.
Explore the docs »

View Demo
Washing machine icons created by Konkapp - Flaticon

Table of Contents
  1. About The Project
  2. Getting Started
  3. Usage
  4. Roadmap
  5. Contributing
  6. License
  7. Contact
  8. Acknowledgments

About The Project

Project Mockups

Created on Figma

(back to top)

Built With

  • Laravel
  • Tailwind CSS
  • Flowbite

(back to top)

Getting Started

To get a local copy up and running follow these simple example steps.

Prerequisites

If you want to use Docker, install Docker. If you are not using Docker, download a software like Xampp, Wampp, ...

Installation

Clone the repository

En SSH

git clone [email protected]:HE-Arc/calm.git

En HTTP

git clone https://github.com/HE-Arc/calm.git

If you are working with Docker, skip to the Docker section

Docker

In a terminal in the project's current folder

docker compose up -d

Once the images have been built, the containers will launch automatically. The application is available at http://localhost:8000.

Sans docker

⚠️Attention

It is necessary to run the command npm install the first time you get the project to install all dependencies. Also, you need to run this command when new packages are added.

Setting up the database

If you are working on a local machine with Xampp, for example, start the apache and mysql services.

To enter the following commands, you need to be in the ~/calm/calm-server/ directory.

Install dependencies and set up the Laravel project.

Before all these operations, you need to copy the .env.example, rename it to .env and place it in the root of the ~\calm-webserver\. You'll need to adapt it to your database configurations.

composer install
php artisan key:generate
php artisan migrate
php artisan db:seed

Launch the project

ℹ️ Important

It is necessary to start the Laravel server and the Vite server during development.

From the subfolder ~\calm\calm-webserver\, in a terminal, enter the following commands:

php artisan serve
npm run dev

The application is available at http://localhost:8000.

(back to top)

Usage

To test the functionality of the application, you can log in as a test user from the login form with the following credentials:

Username

Password

password

(back to top)

Roadmap

See the RoadMap

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

(back to top)

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!

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

(back to top)

License

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

(back to top)

Contact

(back to top)

Acknowledgments

(back to top)

About

Capable and Accessible Laundry Manager (CALM) is a web-based application for managing laundry facilities in rental properties.

Resources

License

Stars

Watchers

Forks