How do I install the Deployment skill?

Run npx skillmds@latest add tomevault-io/deployment-3 in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Deployment safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Deployment?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Deployment free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Deployment?

tomevault-io (@tomevault-io) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Deployment by tomevault-io — Agent Skill

Name: Deployment
Author: tomevault-io

Deployment

Deployment architecture, multi-tenancy design, and environment-specific deployment commands. Use when the user asks about how the application is deployed, multi-tenant architecture with Navigator, Fly.io deployment, or frontend stack details. Use when this capability is needed.

tomevault-io Updated Sep 17, 2026

File contents

Deployment and Architecture

Multi-tenancy Design

Each event runs as a separate Rails instance with its own SQLite database
Navigator (Go web server) or Phusion Passenger manages multiple instances on a single machine
NGINX or Navigator handles routing to the correct instance based on URL patterns
Shared Redis instance for Action Cable across all events on a machine
Navigator is included as a git submodule in the navigator/ directory
See navigator/README.md for details on the Go-based nginx/Passenger replacement

Deployment Environments

Test Environment (Kamal)

URL: https://showcase.party/
Deploy command: bundle exec kamal $* --config-file=deploy.yml
Uses Kamal for deployment orchestration

Staging Environment (Fly.io)

URL: https://smooth-nav.fly.dev/
Deploy command: fly deploy --config nav.toml
Uses Fly.io with custom navigator configuration

Admin/Backup Server (Git Hook)

Runs index admin functions (user and location administration)
Doubles as backup server of last resort
Deploy command: git push (triggers post_update hook)
Uses git push-based deployment with automatic hook execution

Production Environment

Deploy command: fly deploy
Uses Fly.io deployment

Deployment Architecture

Runs on Fly.io across multiple regions globally
Each region contains complete copy of all databases
Automatic rsync backup between regions
PDF generation runs on separate appliance machines via Fly-Replay routing
Navigator supports app-based, machine-based, and region-based request routing
Logging aggregated to dedicated logger instances

Database Schema

SQLite databases per event (~1MB typical size)
Volumes for persistent storage
Automatic backups via rsync to multiple locations
Daily snapshot backups maintained indefinitely

Frontend Stack

Rails 8 with Import Maps (no Node.js build step)
Stimulus.js for JavaScript behavior
Turbo for SPA-like navigation
TailwindCSS for styling
Custom theme support per event

Asset Management

# Precompile assets
bin/rails assets:precompile

# Clean old assets
bin/rails assets:clean

# Remove all compiled assets
bin/rails assets:clobber

Real-time Updates

Action Cable channels for live score updates
Current heat tracking across all ballrooms
WebSocket connections managed per event

Converted and distributed by TomeVault — claim your Tome and manage your conversions.

---name: deployment-3description: Deployment architecture, multi-tenancy design, and environment-specific deployment commands. Use when the user asks about how the application is deployed, multi-tenant architecture with Navigator, Fly.io deployment, or frontend stack details. Use when this capability is needed.---# Deployment and Architecture## Multi-tenancy Design- Each event runs as a separate Rails instance with its own SQLite database- Navigator (Go web server) or Phusion Passenger manages multiple instances on a single machine- NGINX or Navigator handles routing to the correct instance based on URL patterns- Shared Redis instance for Action Cable across all events on a machine- Navigator is included as a git submodule in the `navigator/` directory- See [navigator/README.md](navigator/README.md) for details on the Go-based nginx/Passenger replacement## Deployment Environments### Test Environment (Kamal)- URL: https://showcase.party/- Deploy command: `bundle exec kamal $* --config-file=deploy.yml`- Uses Kamal for deployment orchestration### Staging Environment (Fly.io)- URL: https://smooth-nav.fly.dev/- Deploy command: `fly deploy --config nav.toml`- Uses Fly.io with custom navigator configuration### Admin/Backup Server (Git Hook)- Runs index admin functions (user and location administration)- Doubles as backup server of last resort- Deploy command: `git push` (triggers post_update hook)- Uses git push-based deployment with automatic hook execution### Production Environment- Deploy command: `fly deploy`- Uses Fly.io deployment## Deployment Architecture- Runs on Fly.io across multiple regions globally- Each region contains complete copy of all databases- Automatic rsync backup between regions- PDF generation runs on separate appliance machines via Fly-Replay routing- Navigator supports app-based, machine-based, and region-based request routing- Logging aggregated to dedicated logger instances## Database Schema- SQLite databases per event (~1MB typical size)- Volumes for persistent storage- Automatic backups via rsync to multiple locations- Daily snapshot backups maintained indefinitely## Frontend Stack- Rails 8 with Import Maps (no Node.js build step)- Stimulus.js for JavaScript behavior- Turbo for SPA-like navigation- TailwindCSS for styling- Custom theme support per event## Asset Management```bash# Precompile assetsbin/rails assets:precompile# Clean old assetsbin/rails assets:clean# Remove all compiled assetsbin/rails assets:clobber```## Real-time Updates- Action Cable channels for live score updates- Current heat tracking across all ballrooms- WebSocket connections managed per event---> Converted and distributed by [TomeVault](https://tomevault.io/claim/rubys) — claim your Tome and manage your conversions.

Frequently asked questions