Skip to main content
Disclaimer: SkyTeam ROBLOX is not affiliated with the SkyTeam Airline Alliance, its member airlines, subsidiaries, or airlines listed in this project. The usage of logos is not approved by the respective companies.

​
Welcome to SkyTeam ROBLOX

SkyTeam ROBLOX is a comprehensive airline management system designed for ROBLOX games, providing a complete infrastructure for running virtual airline operations with real-time flight tracking, passenger management, and rewards systems.

Quickstart

Get your SkyTeam system up and running in minutes

Architecture

Learn about the system design and monorepo structure

API Reference

Integrate with the REST API from your ROBLOX game

Setup Guide

Detailed setup and configuration instructions

​
Key Features

Complete flight lifecycle management with support for multiple airlines and brands. Track flights from scheduling through departure, in-flight operations, and arrival. Each airline can operate multiple brands with unique IATA/ICAO codes and branding.
Built-in loyalty program where passengers earn miles for flights and can spend them on airline-specific products. The system tracks all transactions and provides a complete audit trail through the milesTransactions table.
Discord.js-powered bot with slash commands for managing channels, viewing status, and interacting with your airline community. Includes event scheduling and automated notifications.
Native ROBLOX module (SkyTeamModule) that integrates directly into your game via HTTP API. Written in TypeScript with roblox-ts, it handles flight lifecycle events, passenger tracking, and real-time synchronization.
Next.js-based administration interface for managing airlines, brands, flights, products, and viewing analytics. Provides a clean UI for airline operators to manage their operations.
Robust data layer using PostgreSQL with Drizzle ORM for type-safe database operations. Includes tables for users, airlines, brands, flights, passengers, miles transactions, and products.
Organized as a Turborepo monorepo with shared packages for database access and UI components. Enables efficient development across multiple applications with proper dependency management.
Production-ready Docker Compose configuration for deploying all services (web, admin, API, Discord bot) with a single command. Includes networking and environment variable management.

​
System Components

Web Application

Next.js 15 frontend for passengers to view flights, check miles, and browse the marketplace

Admin Panel

Next.js 15 application for airline operators on port 3001

API Server

Express REST API on port 4000 with helmet security and CORS

Discord Bot

Discord.js + Discordx bot with slash commands and event handling

ROBLOX Module

TypeScript module compiled with roblox-ts for in-game integration

Database Package

Shared Drizzle ORM package used across all applications

​
Technology Stack

{
  "node": ">=18.0.0",
  "packageManager": "pnpm@10.5.2"
}

​
Database Schema Overview

The system is built around six core tables:
  • users - Player profiles with miles balances and avatar URLs
  • airlines - Airline organizations with API tokens and Discord servers
  • brands - Airline brands with IATA/ICAO codes and custom branding
  • flights - Flight records with departure/arrival, aircraft, and timing
  • flightPassengers - Passenger manifests with miles earned per flight
  • milesTransactions - Complete audit log of all miles earned and spent
  • milesProducts - Marketplace items purchasable with miles
See the Database Schema documentation for complete details.

​
API Endpoints

The REST API provides endpoints for ROBLOX game integration:

Health Check

GET /health - Server health without authentication

Airline Data

GET /airline - Fetch airline and brand information

Upcoming Flights

GET /flight/fetchUpcomingFlights - Get scheduled flights

Flight Lifecycle

POST /flight/:id/serverStart - Mark flight as started

User Data

POST /users/fetchUsersData - Batch fetch user profiles

Product Purchase

POST /user/:id/buyProduct - Spend miles on products
All API endpoints (except /health) require authentication via the x-api-key header with your airline token.

​
Use Cases

Virtual Airlines - Run realistic airline operations in ROBLOX with flight scheduling, crew management, and passenger tracking. Roleplay Communities - Create immersive airline roleplay experiences with Discord integration for announcements and coordination. Flight Simulators - Add progression systems and rewards to flight simulator games with the miles loyalty program. Multi-Airline Networks - Support multiple airline brands under one umbrella organization with shared infrastructure.

​
Getting Started

Ready to set up your SkyTeam system? Head over to the Quickstart Guide to install dependencies and launch your first development server.

Next: Quickstart

Install and run SkyTeam ROBLOX in under 5 minutes

Build docs developers (and LLMs) love

Get started for freeTalk to us