rubys/deployment
.claude/skills/deployment/SKILL.md
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.
$ install --global
skillsauthnpx skillsauth add rubys/showcase deploymentInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 17, 2026, 2:31 AM10.5s1 file scanned
SKILL.md
- name:
- deployment
- description:
- 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.
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
Related Skills
rubys/testing
development
VerifiedTrustedCommunity
Information about running tests, test coverage, and known testing issues in the Rails application. Use when the user asks about testing procedures, encounters test failures, wants to know about coverage, or needs to troubleshoot intermittent system test issues.
36SKILL.mdUpdated Apr 17, 2026
rubys/render-page
development
VerifiedTrustedCommunity
Use this skill to inspect what a Rails page currently displays, extract HTML content, or verify rendering WITHOUT starting a dev server. Useful for understanding page output before making changes, debugging views, searching for content, or testing that pages work correctly. Provides .claude/skills/render-page/scripts/render.rb for quick page inspection and HTML extraction.
36SKILL.mdUpdated Apr 17, 2026
rubys/navigator
development
VerifiedTrustedCommunity
Working with the Navigator Go submodule for web server fixes and enhancements. Use when deployment plans require Navigator changes, config parsing issues arise, or new routing/proxy behavior is needed.
36SKILL.mdUpdated Apr 17, 2026
rubys/fly-ssh
testing
VerifiedTrustedCommunity
Use when asked to run "fly ssh console", SSH into Fly.io machines, inspect files on production machines, check processes on Fly.io, or examine deployed machine state. Covers critical pitfalls like no shell support and Debian vs macOS command differences.
36SKILL.mdUpdated Apr 17, 2026