If you just want to see the app in action, you can see screenshots here
Before building and running the application, ensure you have the following in place:
- Go: The Go programming language is required for compiling and running the app.
- PostgreSQL: Make sure you have a PostgreSQL server up and running with a database.
- Soda CLI.
- Mail server: Recommended to use mailhog.
-
Open a terminal.
-
Update the package list and install PostgreSQL:
sudo apt update sudo apt install postgresql postgresql-contrib
-
Start and enable the PostgreSQL service:
sudo systemctl start postgresql sudo systemctl enable postgresql
sudo service postgresql start
sudo chkconfig postgresql on
-
Open a terminal.
-
Install PostgreSQL using Homebrew:
brew install postgresql
-
Start and enable the PostgreSQL service:
brew services start postgresql
-
Download the PostgreSQL installer from the official website: PostgreSQL Downloads
-
Run the installer and follow the on-screen instructions to complete the installation.
For more detailed instructions see PostgreSQL official website.
To successfully build and launch the application, please follow these steps:
-
Begin by cloning or downloading the source code from the GitHub repository.
-
Open your terminal or command prompt and navigate to the project directory.
-
Execute the following command to conveniently download and install the necessary Go library dependencies:
go mod download
-
To manage database migrations, you'll need Soda CLI installed. You can install it using the following command:
go install github.com/gobuffalo/pop/v5/soda@latest
-
Perform database migrations using Soda CLI by running:
soda reset
-
You are now ready to build and run the application. Use the following command based on your operating system:
For *NIX:
go build -o bookings cmd/web/*.go ./bookings
For Windows:
go build -o bookings.exe cmd/web/*.go ./bookings.exe
For mail sending - make sure you have a mail server running.
This project is released under the BSD 3-Clause License.