Skip to content

yaStigma/campers-app

Repository files navigation

CAMPERS-APP

EN Project: CAMPERS-APP

The goal of this project is to develop the frontend part of a web application for the company "TravelTrucks," which specializes in camper rentals. The web application features an intuitive design, making it simple and functional. Every user can easily achieve their goal—finding and renting a camper that suits their preferences.


Key Features

  1. Explore the camper fleet available at "TravelTrucks."
  2. Search for a camper based on location, type, and functionality.
  3. View detailed technical specifications of the selected camper.
  4. Browse camper photos and read user reviews.
  5. Add favorite campers to a wishlist.
  6. Use a quick and convenient booking form.

Installation Instructions

To install and run the project, follow these steps:

  1. Clone the repository to your machine:

    git clone https://github.com/yaStigma/campers-app.git

  2. Navigate to the project directory:

    cd campers-app

  3. Install dependencies:

    npm install

  4. Start the project:

    npm run dev

  5. Open http://localhost:3000 in your browser to see the result


Usage Instructions

  1. Navigate to the catalog page, where you can view the entire fleet of available campers. Each camper listing includes a name, image, price, main features, a brief description, and a rating.
  2. To refine your search, specify the city where you're looking for a camper, select one of the three body types, and define additional technical parameters, such as the availability of a kitchen or bathroom.
  3. To view details about a specific camper, click the "Show More" button. This will take you to the camper's details page, where you can check full specifications, browse images, and read user reviews.
  4. To book a camper, fill out the booking form located on the selected camper’s page.

Technologies

  • React: The core library for building the user interface.
  • Vite: A tool for fast development and modern frontend project builds.
  • Redux: A state management library ensuring predictable data handling.
  • React Router: A library for handling routing in React applications.
  • Axios: A library for making HTTP requests.
  • Formik: A tool for building forms and managing their state.
  • Yup: A library for data validation, seamlessly integrating with Formik.

Author

UA Проєкт: CAMPERS-APP

Мета проєкту – створення фронтенд частини веб-додатку для компанії "TravelTrucks", яка займається орендою кемперів. Веб-додаток має інтуїтивно зрозумілий дизайн, простий та функціональний. Кожен користувач з легкістю зможе досягти своєї мети - знайти та орендувати кемпер за своїми побажаннями.


Основні функції

  1. Ознайомлення з парком кемперів наявним у компанії "TravelTrucks".
  2. Пошук необхідного кемпера за місцем знаходження, типом та функціоналом.
  3. Можливість детального ознайомлення з усіма технічними характеристиками обраного кемперу.
  4. Огляд кемперу за наданими фотокартками, ознайомлення з відгуками про використання.
  5. Можливість додавати кемпери, що зацікавили, в обране.
  6. Швидка та зручна форма бронювання.

Інструкції з установки

Щоб встановити та запустити проєкт, виконайте наступні кроки:

  1. Клонуйте репозиторій на свою машину:

    git clone https://github.com/yaStigma/campers-app.git

  2. Перейдіть в директорію проєкту:

    cd campers-app

  3. Встановіть залежності:

    npm install

  4. Запустіть проєкт:

    npm run dev

  5. Відкрийте http://localhost:3000 у вашому браузері, щоб побачити результат.


Інструкції з використання

  1. Перейдіть на сторінку каталогу. До уваги представлено весь парк наявних кемперів з короткою інформацією: назва, зовнішній вигляд, ціна, основний функціонал, скорочений опис, рейтинг.
  2. Для звуження пошуку деталізуйте пошук: вкажіть місто, де шукати кемпер, оберіть один з трьох типів кузова, а також вкажіть інші технічні параметри, які цікавлять, наприклад, наявність кухні чи ванної кімнати.
  3. Щоб переглянути деталі про конкретний кемпер, натисніть на кнопку "Показати більше" та перейдіть на сторінку деталей про кемпер, де можна ознайомитися з повними технічними даними, переглянути фотокартки, прочитати відгуки.
  4. Для бронювання кемпера заповніть форму на бронювання, що знаходиться на сторінці обраного кемпера.

Технології

  • React: Основна бібліотека для створення користувацького інтерфейсу.
  • Vite: Інструмент для швидкої розробки та збірки сучасних фронтенд-додатків.
  • Redux: Бібліотека для управління станом додатку, що забезпечує передбачуваність і зручність у роботі з даними.
  • React Router: Бібліотека для створення маршрутизації в React-додатках.
  • Axios: Бібліотека для здійснення HTTP-запитів.
  • Formik: Інструмент для створення форм і управління їхнім станом.
  • Yup: Бібліотека для валідації даних, яка легко інтегрується з Formik.

Автор

About

Frontend App (Test Task)

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published