Skip to content

Repository files navigation

GoStans - Central Asian Tour & Travel Platform

Overview

GoStans is a comprehensive travel and tour booking platform specializing in Central Asian destinations, particularly Uzbekistan. The platform offers curated tour packages, real-time booking capabilities, and integrated payment processing.

🚀 Features

  • Tour Discovery: Browse and search through curated tour packages across Central Asia
  • Interactive Maps: Mapbox-powered interactive tour route visualization
  • Booking System: Real-time availability checking and instant booking confirmation
  • Payment Integration: Secure payment processing via Stripe and PayPal
  • Mobile Responsive: Fully optimized for mobile and tablet devices
  • Multi-language Support: Available in multiple languages for international travelers
  • User Dashboard: Manage bookings, favorites, and travel preferences
  • Cart Management: Add multiple tours and manage bookings before checkout

Tech Stack

Core

  • React 18.3 - UI library
  • TypeScript - Type safety
  • Vite - Build tool and dev server
  • Styled Components - CSS-in-JS styling
  • Recoil - State management with persistence

UI/UX

  • Framer Motion - Animations and transitions
  • Ant Design - UI component library
  • Lottie React - Animation library
  • Swiper - Touch slider for galleries

API & Services

  • Axios - HTTP client
  • TanStack Query - Server state management
  • Mapbox GL - Interactive maps
  • Stripe & PayPal - Payment processing

Development

  • ESLint - Code linting
  • TypeScript ESLint - TypeScript-specific linting
  • React Router DOM - Client-side routing
  • React Cookie - Cookie management

📦 Installation

Prerequisites

  • Node.js 18+
  • PNPM 8+ (recommended) or npm/yarn

Setup

# Clone the repository
git clone https://github.com/yourusername/gostans.git
cd gostans

# Install dependencies
pnpm install

# Copy environment variables
cp .env.example .env.local

# Start development server
pnpm dev

Contributing

Contributions are welcome! Please fork the repository and submit an issue or pull request for any changes. Please follow the existing code style and run linters/tests before submitting.

License

This project is licensed under the MIT License. See the LICENSE file for details

Contact

Support

For support, please open an issue on GitHub or contact us at gostans.com@gmail.com

Disclaimer

This project is for educational and demonstration purposes only. For commercial use, please contact us at gostans.com@gmail.com