🚌 BusGo - Bus Booking App (Expo)

A sleek, modern bus booking application built with Expo and React Native, featuring Google Sign-In, interactive seat selection, and seamless booking management with production-ready architecture.

✨ Features

🎨 Modern UI/UX - Tailwind CSS with custom Okra typography
🚌 Bus Booking - Search routes, select seats, manage bookings
🔐 Google Sign-In - Secure OAuth authentication
📱 Cross-Platform - iOS and Android with native performance
🪑 Interactive Seats - Real-time seat availability and selection
🔗 Deep Linking - Direct bus access via shareable URLs
⚡ TanStack Query - Efficient data fetching and caching
💾 MMKV Storage - Lightning-fast local storage
🎯 TypeScript - Full type safety and enhanced developer experience
📍 Location Services - City-to-city route discovery

📱 Screenshots

📱 Download & Try

Download and install the APK to experience the bus booking app on your Android device

🏗️ Tech Stack

📱 Frontend

⚛️ Expo 53.0.15 - Development platform
📘 React Native 0.79.4 - Mobile app framework
🗺️ React Navigation 7.x - Navigation with deep linking
🎨 NativeWind 4.1.23 - Tailwind CSS for React Native

🔄 State Management & Data

⚡ TanStack Query 5.81.5 - Server state management
🌐 Axios 1.10.0 - HTTP client for API requests
🔑 JWT Decode 4.0.0 - Token management

🎨 UI & Styling

🎨 NativeWind 4.1.23 - Tailwind CSS styling
🌈 React Native Linear Gradient 2.8.3 - Gradient effects
🎯 React Native Heroicons 4.0.0 - Icon library
🖼️ React Native SVG 15.9.0 - SVG support

🔧 Authentication & Storage

🔐 Google Sign-In 15.0.0 - OAuth authentication
💾 React Native MMKV 3.3.0 - Fast key-value storage

📱 Device Features

📅 DateTimePicker 8.4.2 - Native date/time selection
🎭 React Native Reanimated 3.18.0 - Smooth animations
👆 React Native Gesture Handler 2.27.1 - Touch gestures
📤 React Native Share 12.1.0 - Native sharing
📸 React Native View Shot 4.0.3 - Screenshot capture

🚀 Getting Started

Prerequisites

Node.js (≥18.0.0)
Expo CLI
Expo account
Android Studio (Android)
Xcode (iOS - Mac only)

Installation

Clone the repository

git clone https://github.com/chayan-1906/Busgo-React-Native.git
cd Busgo-React-Native

Install dependencies
```
npm install
```
iOS Setup (Mac only)
```
npm run pod-install
```
Environment Setup

Create .env file (refer to .env.example)
Start Expo dev server
```
npm start
```

Run on device/simulator

# Android
npm run android

# iOS
npm run ios

📦 Build for Production

Android APK

npm run generate-apk

APK will be generated at: android/app/build/outputs/apk/release/app-release.apk

iOS Build

Use Xcode for iOS production builds:

Open ios/BusGo.xcworkspace
Select target device/simulator
Product → Archive

🏗️ Project Structure

src/
├── components/         # Reusable UI components
│   ├── home/          # Home screen components
│   ├── ui/            # Generic UI components
│   └── ui/modals/     # Modal components
├── screens/           # Application screens
├── navigation/        # Navigation configuration
├── service/           # API client and requests
│   └── requests/      # API endpoint handlers
├── types/             # TypeScript type definitions
├── utils/             # Utility functions and constants
└── assets/            # Images, fonts, and static files

🗄️ Backend API

The app uses a hosted Node.js backend. Local setup is optional.

Hosted API

Production: https://busgo-node-js.onrender.com/api/v1
Status: Live & Ready

Local Setup (Optional)

# Clone the backend repository
git clone https://github.com/chayan-1906/BusGo-Node.js.git
cd BusGo-Node.js

# Install dependencies
npm install

# Setup environment variables
cp .env.example .env

# Start server
npm run dev

API Endpoints

Authentication: /user/login (POST)
RefreshToken: /user/refresh-token (POST)
Cities: /city (GET)
Buses: /bus/search?from={from}&to={to}&date={date}&tags={tags}&sortBy={sortBy} (GET)
BusDetails: /bus?busId={busExternalId} (GET)
Tickets: /ticket (GET)
BookTicket: /ticket (POST)

Repository

🔗 BusGo Node.js Backend

🔗 Deep Linking

URL Scheme

busgo://bus/{busExternalId}

Examples

# Direct bus access
busgo://bus/BUS_12345

# Open from terminal (Android)
adb -s 368fef2d shell am start -a android.intent.action.VIEW -d "busgo://bus/BUS_12345"
xcrun simctl openurl booted "busgo://bus/BUS_12345"

🎯 Key Highlights

Production Ready: Optimised Expo prebuild for iOS and Android
Modern Architecture: Clean code with TypeScript and TanStack Query
Offline First: MMKV storage with optimistic updates
Secure: JWT authentication with Google Sign-In
Performance: 60fps animations with Reanimated 3
Developer Friendly: ESLint, Prettier, and hot reload

📋 Requirements

Android

Min SDK: 21 (Android 5.0)
Target SDK: 34 (Android 14)
Architecture: arm64-v8a, armeabi-v7a

iOS

Min Version: iOS 13.0
Architecture: arm64

Development

Node.js: ≥18.0.0
Expo CLI: Latest
Android Studio: Latest stable

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Fork the project
Create your feature branch (git checkout -b feature/AmazingFeature)
Commit your changes (git commit -m 'Add some AmazingFeature')
Push to the branch (git push origin feature/AmazingFeature)
Open a Pull Request

👨‍💻 Author

Padmanabha Das

🌟 Show Your Support

If this project helped you, please give it a ⭐️!

📱 Connect With Me

Made with ❤️ by Padmanabha Das

⭐ Star this repo if you found it helpful!

Note: This is the Expo prebuild implementation. Bare React Native version also available.

Name		Name	Last commit message	Last commit date
Latest commit History 30 Commits
android		android
assets		assets
ios		ios
src		src
.env.example		.env.example
.gitignore		.gitignore
App.tsx		App.tsx
README.md		README.md
app.json		app.json
babel.config.js		babel.config.js
eslint.config.js		eslint.config.js
global.css		global.css
index.js		index.js
metro.config.js		metro.config.js
nativewind-env.d.ts		nativewind-env.d.ts
package.json		package.json
tailwind.config.js		tailwind.config.js
tsconfig.json		tsconfig.json

chayan-1906/Busgo-React-Native

Folders and files

Latest commit

History

Repository files navigation