> ## Documentation Index
> Fetch the complete documentation index at: https://mintlify.com/Braian551/viax/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction to Viax

> Learn about the Viax mobility platform - a comprehensive solution for on-demand transportation and delivery services

# Welcome to Viax

Viax is a modern **mobility and on-demand services platform** that connects users, drivers, and administrators in a seamless ecosystem for transportation and delivery services.

<img src="https://mintlify.s3.us-west-1.amazonaws.com/braian551-viax/images/viax-hero.png" alt="Viax Platform" />

## What is Viax?

Viax is a complete digital platform similar to apps like Uber or DiDi, designed to provide:

<CardGroup cols={2}>
  <Card title="For Users" icon="user">
    Request rides and deliveries with real-time tracking, estimated pricing, and secure payments
  </Card>

  <Card title="For Drivers" icon="car">
    Accept ride requests, manage earnings, and track performance through an intuitive driver interface
  </Card>

  <Card title="For Companies" icon="building">
    Manage fleets, monitor operations, and oversee service quality with administrative tools
  </Card>

  <Card title="For Administrators" icon="shield">
    Complete control over platform operations, user verification, and business analytics
  </Card>
</CardGroup>

## Key Capabilities

### Real-Time Geolocation

* GPS tracking for accurate pickup and dropoff locations
* Interactive maps powered by Mapbox and OpenStreetMap
* Route calculation with traffic information from TomTom API
* Geocoding for address-to-coordinates conversion

### Smart Matching System

* Automatic driver search within 5km radius
* Vehicle type matching (motorcycles, cars, cargo vehicles)
* Driver verification and approval workflows
* Real-time availability status

### Complete Trip Management

* Trip request creation and confirmation
* Fare calculation based on distance, time, and vehicle type
* Multiple service types (rides and package delivery)
* Trip status tracking from request to completion

### Secure Authentication

* User registration with email verification
* 6-digit verification codes via PHPMailer
* Session management and secure login
* Role-based access control

## Technology Stack

<Tabs>
  <Tab title="Frontend">
    * **Flutter** 3.35.3+ (Cross-platform mobile app)
    * **Dart** 3.0+ (Programming language)
    * **Provider** (State management)
    * **flutter\_map** (Interactive maps)
    * **geolocator** (GPS positioning)
  </Tab>

  <Tab title="Backend">
    * **PHP** 8.3+ (Server-side logic)
    * **MySQL** 8.0+ (Database)
    * **PHPMailer** (Email service)
    * **Composer** (Dependency management)
  </Tab>

  <Tab title="APIs">
    * **Mapbox** (Maps tiles and routing - 100k/month free)
    * **TomTom** (Traffic data - 2.5k/day free)
    * **Nominatim** (Geocoding - unlimited)
  </Tab>
</Tabs>

## Platform Architecture

Viax is built with **Clean Architecture** principles, separating concerns into distinct layers:

```
Frontend (Flutter Mobile App)
├── Authentication & Verification
├── Interactive Maps & Geocoding
├── GPS & Route Calculation
└── Professional UI/UX

Backend (PHP + MySQL)
├── REST API Endpoints
├── Email Verification System
├── User & Driver Management
├── Admin Dashboard
└── Cloud Database
```

## Current Status

<Info>
  Viax is **production-ready** with a fully functional MVP deployed on VPS infrastructure.
</Info>

### Implemented Features

* ✅ Complete authentication with email verification
* ✅ Interactive maps with geocoding
* ✅ Real-time GPS tracking
* ✅ Route calculation and traffic information
* ✅ PHP/MySQL backend deployed on VPS
* ✅ Professional UI/UX design
* ✅ Admin dashboard
* ✅ Driver document management

### In Development

* 🚧 Trip booking and reservation system
* 🚧 Push notifications
* 🚧 In-app chat between users and drivers
* 🚧 Rating and review system

### Future Roadmap

* 📋 Payment gateway integration
* 📋 Advanced driver features
* 📋 Performance optimization
* 📋 Google Play Store deployment

## Why Choose Viax?

<AccordionGroup>
  <Accordion title="Modern Technology">
    Built with Flutter for cross-platform compatibility and native performance on both iOS and Android.
  </Accordion>

  <Accordion title="Scalable Architecture">
    Clean Architecture implementation allows easy migration to microservices as your business grows.
  </Accordion>

  <Accordion title="Cost-Effective">
    Uses free-tier APIs (Mapbox, TomTom, Nominatim) for essential mapping and routing features.
  </Accordion>

  <Accordion title="Complete Solution">
    Includes user app, driver app, and admin dashboard - everything needed to launch a mobility platform.
  </Accordion>

  <Accordion title="Production Ready">
    Deployed on VPS with MySQL database, ready for real-world operations.
  </Accordion>
</AccordionGroup>

## Next Steps

<Steps>
  <Step title="Get Started">
    Follow our [Quickstart Guide](/quickstart) to set up your development environment
  </Step>

  <Step title="Explore Features">
    Learn about all [Platform Features](/features) available in Viax
  </Step>

  <Step title="Understand Architecture">
    Read about the [System Architecture](/concepts/architecture) and design decisions
  </Step>

  <Step title="Deploy">
    Follow the [Production Deployment](/setup/production-deployment) guide when ready
  </Step>
</Steps>

<Note>
  For detailed technical documentation, configuration guides, and troubleshooting, explore the sections in the navigation menu.
</Note>