Skip to main content

Welcome to Viax

A complete ride-hailing platform connecting users, drivers, and administrators with real-time GPS tracking, intelligent routing, and powerful operational controls.

Get StartedExplore API
// Initialize Viax
POST /auth/login
GET /trips/status
POST /map/route
✓ Real-time tracking
✓ Smart routing
✓ Driver management

Quick Start

Get your Viax platform up and running in minutes with our comprehensive setup guide.

1

Install Flutter dependencies

Clone the repository and install the required Flutter packages.
git clone https://github.com/Braian551/viax.git
cd viax
flutter pub get
2

Configure environment

Set up your environment variables for development or production.
// lib/src/core/config/app_config.dart
static const String _envBaseUrl = String.fromEnvironment(
  'API_BASE_URL',
  defaultValue: 'http://76.13.114.194', // Production
);
  • Production: http://76.13.114.194
  • Local Development: http://192.168.x.x/viax/backend
  • Android Emulator: http://10.0.2.2/viax/backend
3

Run the application

Launch the app on your device or emulator.
flutter run
For production builds, use flutter build apk --release or flutter build appbundle --release
4

Configure backend (optional)

If running locally, set up the PHP backend with MySQL.
# Using Laragon (Windows)
./setup_local.ps1

# Or manually configure database
# Create database 'viax'
# Import basededatosfinal.sql
See the Local Development guide for detailed instructions.

Explore by Role

Jump into documentation tailored for your specific use case.

For Users

Learn how to book rides, track trips, and manage your profile

For Drivers

Get started with driver onboarding, trip management, and earnings

For Admins

Manage users, drivers, configure pricing, and monitor operations

Key Features

Powerful capabilities built into the Viax platform.

Real-time GPS Tracking

Track user and driver locations in real-time with high accuracy positioning

Intelligent Routing

Calculate optimal routes using Mapbox with traffic-aware navigation

Dynamic Pricing

Flexible pricing system with distance, time, and surge calculations

Driver Verification

Comprehensive document verification and approval workflows

Admin Dashboard

Real-time analytics, user management, and operational insights

Push Notifications

Firebase-powered notifications for trip updates and driver alerts

Location Sharing

Share trip location with friends and family for safety

Clean Architecture

Maintainable, testable codebase ready for scale and microservices

Technical Resources

Deep dive into architecture, setup, and API integration.

Architecture Overview

Learn about Viax’s modular architecture, clean code principles, and microservices readiness.

Explore architecture

Setup Guide

Complete installation and configuration guide for local development and production deployment.

Get started

API Reference

Complete REST API documentation with endpoints for auth, trips, maps, and admin operations.

View API docs

Platform Features

Discover all features including GPS tracking, routing, pricing, notifications, and more.

See all features

Ready to build your mobility platform?

Start with our quickstart guide and have your first ride-hailing feature running in minutes.

Get Started Now

Build docs developers (and LLMs) love

Get started for freeTalk to us