Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/eduardo06sp/flight-booker

A mobile-friendly web application where visitors may book a one-way flight for multiple passengers.
https://github.com/eduardo06sp/flight-booker

heroku minitest rails responsive ruby ruby-on-rails testing

Last synced: 26 days ago
JSON representation

A mobile-friendly web application where visitors may book a one-way flight for multiple passengers.

Awesome Lists containing this project

README

        

# Flight Booker
![A screenshot displaying the website with flight results](https://i.postimg.cc/VvzMmZZt/Screenshot-from-2022-06-28-21-38-06.png)

A mobile-friendly web application where visitors may book a one-way flight for multiple passengers.

## General Information
Flight Booker is the easiest place to book your next flight! Visitors may search for then select a flight, and then they may add details for each passenger.

Bookings and passengers are created and saved simultaneously.

This project was created using Rails 7 and Ruby 3.1.2. Minitest, Capybara, and Selenium were used to create system and functional tests alongside fixtures. Search results are updated using Turbo Frames, which allows the app to target and update only the relevant part of the page. To avoid an excess amount of forms, passengers are created with bookings simultaneously through the use of nested forms.

## Installing / Getting Started
> Prerequisites:
> * Ruby >= 3.1.2
> * Rails >= 7.0.3
> * Bundler >= 2.3.6
> * PostgreSQL >= 14.3

```bash
git clone https://github.com/Eduardo06sp/flight-booker.git
cd flight-booker/
bundle install
bin/rails server
```

Then visit http://localhost:3000/ to view the application.

### Running System / Functional Tests
> Prerequisites:
>
> FireFox >= 101 (may work on older versions)

Within the cloned `flight-booker` folder, run:
```bash
bin/rails test:all
```

To exclude resource-heavy system tests, run:
```bash
bin/rails test
```

## Features
* Nested forms to create multiple objects with a single submission
* Database seeds to populate application with sample, starter data
* System & functional tests to ensure proper application functionality
* Dynamic addition/removal of passengers using Stimulus
* Fast searching using Turbo Frames
* Responsive design
* Confirmation emails (*note:* only available in a local clone, not live / deployed)

## Reporting Issues / Feedback / Contact
Bug reports are greatly appreciated. You may create a new issue with a simple description of the problem, and any steps leading up to it.
PRs are kindly appreciated.

You may also email me at: [email protected]

## Acknowledgements

* [The Odin Project](https://www.theodinproject.com/home), the best resource I have come across for learning full-stack web development
- For providing the idea for this project ([see the instructions for this project here!](https://www.theodinproject.com/lessons/ruby-on-rails-flight-booker))
- For their absolutely wonderful Discord community

* The Noun Project [artist Phạm Thanh Lộc](https://thenounproject.com/thanhloc1009/) for [the "Plane" art](https://thenounproject.com/icon/plane-2322367/) (used as a favicon)

* The Noun Project [artist Whales Factory](https://thenounproject.com/whales.factory/) for [the "Flight On" art](https://thenounproject.com/icon/flight-on-4179048/) (used as a logo)

* Flaticon [artist Kliwir Art](https://www.flaticon.com/authors/kliwir-art) for [the plus icon art](https://www.flaticon.com/premium-icon/plus_4315609?term=plus&page=1&position=6&page=1&position=6&related_id=4315609&origin=tag) (used in the button to add passengers)