Skip to content

axelbellec/boop

Repository files navigation

Boop: Bordeaux Bike Rack Finder

Boop Twitter Preview

A few hours' project to help me track down bike racks when venturing into new areas of Bordeaux

Boop (short for Bordeaux bike hoops) is a sleek web application that helps cyclists in Bordeaux locate available bike racks. Leveraging the power of Mapbox GL and the Bordeaux Metropole Open Data API, Boop provides an interactive map interface to visualize various types of bike racks across the city.

🚀 Live Demo

Experience Boop in action: https://boop-bay.vercel.app/

🎯 Purpose

As cycling gains popularity in urban areas, finding secure parking spots for bikes becomes crucial. While Bordeaux generally has an abundance of bike racks with one usually in sight, Boop provides a helpful tool for those times when you need specific information.

Boop addresses this need by offering:

  • Up-to-date visualization of bike rack locations
  • Information on rack types (standard, cargo, or motorbike)
  • Number of available hoops at each location (capacity)

This app is particularly useful when you need to find a specific type of rack or want to plan ahead for areas you're less familiar with.

🛠 Tech Stack

Boop is built with these technologies:

  • SvelteKit: for building a fast, efficient, and SEO-friendly web application
  • Mapbox GL JS: for rendering interactive maps (this library is awesome, check it out!)
  • Vite: as the build tool and development server
  • TypeScript: for type-safe JavaScript development
  • Vercel: for seamless deployment and hosting

🗺 Features

  • Interactive map interface
  • Cluster view for dense areas
  • Detailed information on click/tap
  • Responsive design for mobile and desktop
  • Geolocation support
  • Server-side caching for improved performance

Here's what's planned for future development:

  • Add an "About" section to explain the project's approach and purpose in more detail
  • Fix styling glitches
  • Implement a feature to highlight the closest bike racks to the user's location
  • Enhance the user interface for a more visually appealing experience
  • Add dataset for drinking fountains
  • Add dataset for public toilets
  • Add dataset for mandatory parking zones for free-floating vehicles

🚴‍♂️ Types of Bike Racks

Boop visualizes three types of bike racks:

  • 🚲 Standard bicycle racks
  • 🚚 Cargo bicycle racks
  • 🏍 Motorbike racks (there are only a few of them)

Each rack type is color-coded on the map for easy identification.

🛠 Development

To set up the project locally:

  1. Clone the repository
  2. Install dependencies:
    npm install
  3. Create a .env file with your Mapbox access token:
    VITE_MAPBOX_ACCESS_TOKEN=your_mapbox_token_here
    
  4. Start the development server:
    npm run dev

🤝 Contributing

Contributions to Boop are welcome! Whether it's bug fixes, feature additions, or documentation improvements, feel free to open a pull request.

📄 License

Boop is open-source software licensed under the MIT license.

🙏 Acknowledgements

  • Bordeaux Metropole for providing the open data API
  • Mapbox for their excellent mapping platform
  • The Svelte and SvelteKit communities for their fantastic tools and support

Happy cycling, Bordeaux! 🚴‍♂️🇫🇷