airship-one-dev

Guide Airship One development with TypeScript, Vite, and Three.js architecture.

1|Updated Feb 14, 2026
One-click install
npx skills add https://github.com/TimelessP/airshipone --skill airship-one-dev
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: airship-one-dev
Source: https://github.com/TimelessP/airshipone/tree/main/.github/skills/airship-one-dev
Command: npx skills add https://github.com/TimelessP/airshipone --skill airship-one-dev

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill provides a comprehensive guide for developers working on the Airship One project, ensuring consistency in runtime architecture, tooling, release processes, and debugging.

Core Features & Use Cases

  • Runtime Architecture: Details the modular ECS, typed event queue, and multi-rate update domains.
  • Developer Tooling: Outlines the npm-first approach and essential development scripts.
  • Release Flow: Defines the PWA versioning and release build process.
  • Debugging: Offers practical checks and known pitfalls for common issues.
  • Use Case: A new contributor can use this Skill to quickly understand the project's structure, how to run the development server, and the steps required to build and release a new version.

Quick Start

Run the ./dev-run.sh script to start the development server.

Frequently Asked Questions about airship-one-dev

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I set up a local development server for a TypeScript Vite Three.js project?

To set up local development for a TypeScript Vite Three.js project, run the `./dev-run.sh` script. This starts the development server using the npm-first tooling approach defined in the development playbook.

What is modular ECS architecture and how does it work with a typed event queue in Three.js?

Modular ECS architecture in Three.js separates entity data from logic, synchronizing updates via a typed event queue. This structure enforces multi-rate update domains, ensuring consistent runtime processing across distinct game systems.

How do I build and release a PWA version with Vite for CI/CD deployment on GitHub Pages?

To release a PWA version with Vite for GitHub Pages, follow the defined release flow for PWA versioning and build generation. The playbook guides the CI/CD deployment process to publish the updated build.

Can I use npm-first tooling for Three.js debugging checks and release builds without extra dependencies?

Yes, you can use npm-first tooling for Three.js debugging and release builds without extra dependencies. The playbook provides practical debugging checks and defines the release process relying solely on npm scripts.

Why does my multi-rate update domain logic fail during TypeScript Three.js debugging?

Multi-rate update domain logic fails during debugging when typed event queues are improperly sequenced or ECS modules are misconfigured. The playbook offers practical checks and known pitfalls to resolve these common runtime issues.