Table Of Contents

• Project Link
• Getting Started
• Contributors
• About The Project
  • Technologies Used
  • Web APIs
  • User Flow
  • Wireframes
• Plans For Improvement
• Screenshots
  • Desktop index page with modal
  • Desktop index page with categories
  • Desktop index page with randomly generated activity card
  • Desktop my activities page
  • Desktop selected activity search results page
  • Mobile index page with modal
  • Mobile index page with categories
  • Mobile index page with a randomly generated activity card
  • Mobile my activities page
  • Mobile selected activities

Project Link

Click here to view the project on Github pages.

Getting Started

• Clone the Github Project into your local machine
• Navigate into the project
• Open the project into VSCode
• Open the 'index.html' into your default browser

git clone git@github.com:conorjkelly96/bored-as-book.git
cd bored-as-book
code .

Contributors

• Sumaia Sorna
• Andrada Gacichevici
• Conor Kelly
• Matt Palmer
• Yashemabeth

About The Project

An app which allows users to randomly generate a list of activities given a random list of criteria, price, participants. The users will be presented with options and will be able to swipe left (delete) or swipe right (add to basket). API sourced from https://www.boredapi.com/documentation.

Once the user has done navigating their list of activities, they can review their activity bucket-list on the "my boredom list". They will be presented with cards displaying their choices. The uSearch tool bar will allow users to make simple web queries from inside the app to search for activities in their local area. API sourced from https://rapidapi.com/blog/web-search-api-with-python-php-ruby-javascript-examples/.

Technologies Used

Web APIs

We used three different APIs to get the required data for this project

• Bored.API
• DadJoke.API
• WebSearch.API

User Flow

• AS a user
• I want to select a category
• SO that a random activity is generated
• IF I select yes
• THEN the activity is saved in my activities
• WHEN in my activities
• I have the option to select remove activity from results
• WHEN selecting a specific result
• THEN a selection of relevant search results are shown
• WHEN I visit the home page, a random joke is shown on the screen.

Wireframes

Plans For Improvement

• Add loading modals to indicate that API call is being made
• Add additional API such as Ticketmaster API to provide event information for relevant activity results
• Add Spotify API to provide user with music playlists when they choose music categories

Screenshots

• Desktop index page with modal
• Desktop index page with categories
• Desktop index page with a randomly generated activity card
• Desktop my activities page
• Desktop selected activity search results page
• Mobile index page with modal
• Mobile index page with categories
• Mobile index page with a randomly generated activity card
• Mobile my activities page
• Mobile selected activities search results