Live Site: https://vatsim-selector.netlify.app

A web application that helps virtual pilots on the VATSIM network find Virtual SWA routes with ATC coverage across all positions.

• 1,327 Routes: Browse Virtual SWA routes from 109 airports
• Advanced Filtering: Filter by departure/arrival airports and specific ATC positions
• Granular ATC Level Selection: Choose specific positions (Center, Approach, Tower, Ground, Delivery)
• Real-Time Controller Data: Live updates every 30 seconds from VATSIM API
• Detailed Controller Information: View callsigns, frequencies, and online time
• Departure Grouping: Routes organized by departure airport for easy browsing
• Dark Mode: Modern dark theme optimized for readability
• Responsive Design: Distinct mobile (card) and desktop (table) layouts
• Filter-First UX: Start with filters to find exactly what you need

• Node.js (v18 or later)
• npm or pnpm

1. Install dependencies:

npm install

2. Start the development server:

npm run dev

3. Open your browser to http://localhost:5173

npm run build
npm run preview

src/
├── lib/
│   ├── components/        # Svelte components
│   ├── data/             # Airport and route JSON data
│   ├── utils/            # Utility functions
│   └── types/            # TypeScript interfaces
├── routes/               # SvelteKit pages
└── tests/                # Unit and E2E tests

For detailed architecture information, see ARCHITECTURE.md.

• Framework: SvelteKit 5 with runes
• Language: TypeScript (strict mode)
• Styling: Tailwind CSS v4
• Testing: Vitest + Playwright
• Data: Client-side JSON (no backend required)

VATSIM (Virtual Air Traffic Simulation Network) is a volunteer-run network providing realistic air traffic control for flight simulation enthusiasts. Since not all ATC positions are staffed at all times, this tool helps virtual pilots find routes where controllers are active.

Note: This application is not affiliated with VATSIM, Southwest Airlines, or any official aviation authority. It is a community tool for flight simulation enthusiasts. It is not to be used for any form of real world flight planning or otherwise.

npm test              # Unit tests (watch mode)
npm run test:run      # Unit tests (single run)
npm run test:e2e      # E2E tests with Playwright
npm run check         # TypeScript validation

• ARCHITECTURE.md - Component architecture and design patterns
• PRD.md - Product requirements and features
• TESTING.md - Testing strategy and guidelines

When developing inside a GitHub Copilot Docker Sandbox, native Node.js binaries (esbuild, lightningcss, rollup) crash on the virtiofs shared filesystem due to mmap/FUSE issues on aarch64. The workaround is to install node_modules on the sandbox's local ext4 filesystem and symlink it into the workspace.

# 1. Create local deps directory and copy package files
DEPS_DIR="/home/agent/project-deps"
mkdir -p "$DEPS_DIR"
cp package.json package-lock.json "$DEPS_DIR/"

# 2. Install on local ext4 filesystem
cd "$DEPS_DIR" && npm ci

# 3. Symlink node_modules into the workspace
cd /Users/geektrainer/repos/vatsim-flight-scheduler
rm -rf node_modules
ln -s "$DEPS_DIR/node_modules" node_modules

# 4. Install Playwright browsers for E2E tests
npx playwright install --with-deps chromium

• The workspace is mounted via virtiofs (bidirectional file sync between macOS host and Linux VM)
• Native Go/Rust binaries crash with mmap alignment failures on virtiofs
• /home/agent/ is local ext4 inside the sandbox — native binaries run correctly there
• vite.config.ts dynamically detects the symlink and adds the target to Vite's server.fs.allow list
• On macOS, npm ci naturally replaces the (broken) symlink with a real node_modules directory — no manual steps needed

If package.json or package-lock.json changes, repeat the setup steps above to reinstall.

This is a personal project, but suggestions and feedback are welcome! For development guidelines, see the documentation above.

MIT License - see LICENSE file for details.

While the author (GeekTrainer) is a GitHub employee, this project was created independently during personal time and is not affiliated with, endorsed by, or supported by GitHub, Inc. This is a personal open-source project built for the flight simulation community.