History

Claude 2d62b470f6 fix(tui): add guardrails as files instead of submodule Embedded repo was committed as submodule (160000). Now includes all guardrails files directly for full in-repo reference. Authored by TheArchitectit		2026-06-11 18:29:45 -05:00
..
README.md	fix(tui): add guardrails as files instead of submodule	2026-06-11 18:29:45 -05:00
app.rb	fix(tui): add guardrails as files instead of submodule	2026-06-11 18:29:45 -05:00
game-admin-dashboard.rb	fix(tui): add guardrails as files instead of submodule	2026-06-11 18:29:45 -05:00
world-builder.rb	fix(tui): add guardrails as files instead of submodule	2026-06-11 18:29:45 -05:00

README.md

Rails 8.0+ Hotwire UI Examples

Stack: Rails 8.0, Hotwire (Turbo + Stimulus), ViewComponent, Ruby 3.3+

Purpose: Production-ready patterns for game admin dashboards, world-building tools, and ethical engagement systems.

2026 Best Practices

Architecture Principles

Principle	Implementation
Component-Based	ViewComponent for reusable UI components
Progressive Enhancement	Turbo for navigation, Stimulus for interactivity
No JavaScript Framework	Server-rendered HTML with minimal JS
Type Safety	RBS (Ruby Signatures) for method contracts
Accessibility	ARIA labels, semantic HTML, keyboard navigation

Game Design Integration

Real-time dashboards using Turbo Streams
Generative world builders with Stimulus controllers
Analytics visualization with server-side rendering
Ethical engagement patterns (transparent loot tables, Rest-State Mechanics)

Ethical Engagement Patterns

Loot Table Transparency

# Display drop rates, expected value, and pity timers
# Never hide odds from players
# Comply with regional regulations (China, Belgium, etc.)

Rest-State Mechanics

# Design offline regeneration systems
# Respect player time and engagement boundaries

Accessibility Standards

Category	Requirement
Semantic HTML	Proper heading hierarchy, landmarks
ARIA Labels	All interactive elements labeled
Keyboard Nav	Tab navigation, focus management
Color Contrast	WCAG AA minimum (4.5:1)
Motion	Reduced motion support

File Structure

examples/ruby/rails-ui/
├── README.md              ← This document
├── app.rb                 ← Rails 8 Hotwire architecture
├── game-admin-dashboard.rb ← Admin dashboard patterns
├── world-builder.rb       ← Generative world builder

examples/swift/swiftui-game/ - SwiftUI 6 game UI
examples/php/laravel-ui/ - Laravel 11 Livewire dashboards
examples/typescript/ui-components/ - TypeScript UI patterns

Authored by: Project Sentinel Version: 1.0 Last Updated: 2026-03-14 Stack: Rails 8.0, Hotwire, ViewComponent, Ruby 3.3