Skip to content

hexxt-git/madinati

Repository files navigation

Madinati Route Finder Demo

Welcome to The Madinati Route Finder Demo

An application 📲 developed to address a real-world problem 🌍 by Team Hartaka 🗣️

Madinati transforms the way you navigate Algerian cities through an intelligent urban transport platform. By seamlessly integrating various public transport options, we make city exploration and daily commuting effortless and efficient. Whether you're a tourist discovering Algeria's rich cultural heritage or a local planning your daily route, our platform ensures a smooth journey through the urban landscape.

The Spark Behind Madinati 🧭

Our journey began at the prestigious "Boumerdes Smart City" Hackathon 2024, where a personal challenge became our mission. While attempting to reach the event venue, we faced the common struggles of public transport navigation: unreliable schedules, unclear routes, and outdated information. Existing solutions like Google Maps fell short in our local context, inspiring us to create a solution tailored for Algeria's unique urban landscape. We envisioned a platform that would enable the user to go from point A to point B without the stress of planning, asking for directions, or waiting for the next bus. The application had to provide real-time updates, personalized routes based on user preferences, and a seamless experience for both locals and tourists.

Technical Innovation 🧠

At the heart of Madinati lies a sophisticated pathfinding system, powered by our custom version of the Dijkstra algorithm. This system processes comprehensive data from Algiers' integrated transport network, including buses, metro lines, trams, and telepheriques. Our solution adapts to real-time conditions, ensuring you always have the most efficient route at your fingertips.

Through dynamic route calculations and crowdsourced traffic updates, Madinati offers personalized journey options that consider your preferences and current conditions. Whether you're a daily commuter or a tourist exploring the city's treasures, Madinati stands as your reliable urban navigation companion, making every journey smoother and more predictable.

Tools and Technologies Used

Next.js React Tailwind CSS Leaflet Axios Radix UI React Hook Form Zod shadcn/ui TypeScript

  • Next.js: A React framework for building server-side rendered applications.
  • React: A JavaScript library for building user interfaces.
  • Tailwind CSS: A utility-first CSS framework for rapid UI development.
  • Leaflet: An open-source JavaScript library for mobile-friendly interactive maps.
  • Axios: A promise-based HTTP client for the browser and Node.js.
  • Radix UI: A set of accessible, unstyled UI components for building high-quality design systems and web apps.
  • React Hook Form: A performant, flexible, and extensible form library for React.
  • Zod: A TypeScript-first schema declaration and validation library.

Commands to Run the Project

Dependencies

To install the project dependencies, run:

npm install

Development

To start the development server, run:

npm run dev

Build

To build the project for production, run:

npm run build

Start

To start the production server, run:

npm run start

Lint

To lint the project, run:

npm run lint

The Team 🧍‍♂️🧍‍♂️🧍‍♂️🧍‍♂️

  • Bentafat Wail - Back-End
  • Zeghdani Salah - Front-End
  • Maria Bezzaz - Design
  • Ramy Hadid - Front-End

About

find your way around algeirs

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published