Framework updates

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

docs/CLAUDE.dist.md

@@ -446,6 +446,29 @@ The process involves creating Action classes with @route decorators and converti
 
 Details: `php artisan rsx:man scss`
 
+### Responsive Breakpoints
+
+RSX replaces Bootstrap's default breakpoints (xs/sm/md/lg/xl/xxl) with semantic device names.
+
+**Tier 1 - Semantic**:
+- `mobile`: 0 - 1023px (phone + tablet)
+- `desktop`: 1024px+
+
+**Tier 2 - Granular**:
+- `phone`: 0 - 799px | `tablet`: 800 - 1023px | `desktop-sm`: 1024 - 1699px | `desktop-md`: 1700 - 2199px | `desktop-lg`: 2200px+
+
+**SCSS Mixins**: `@include mobile { }`, `@include desktop { }`, `@include phone { }`, `@include tablet { }`, `@include desktop-sm { }`, etc.
+
+**Bootstrap Classes**: `.col-mobile-6`, `.col-desktop-4`, `.d-mobile-none`, `.d-tablet-block`, `.col-phone-12 .col-tablet-6 .col-desktop-sm-4`
+
+**Utility Classes**: `.mobile-only`, `.desktop-only`, `.phone-only`, `.hide-mobile`, `.hide-tablet`
+
+**Note**: Bootstrap's default classes like `.col-md-6` or `.d-lg-none` do NOT work - use the RSX breakpoint names instead.
+
+**JS Detection**: `Responsive.is_mobile()`, `Responsive.is_desktop()` (Tier 1 - broad); `Responsive.is_phone()`, `Responsive.is_tablet()`, `Responsive.is_desktop_sm()`, `Responsive.is_desktop_md()`, `Responsive.is_desktop_lg()` (Tier 2 - specific ranges)
+
+Details: `php artisan rsx:man responsive`
+
 ### JavaScript for Blade Pages
 
 Unlike SPA actions (which use component lifecycle), Blade pages use static `on_app_ready()` with a page guard:
@@ -1208,10 +1231,24 @@ class Main extends Main_Abstract
 ## GETTING HELP
 
 ```bash
-php artisan rsx:man <topic>  # Detailed docs
+php artisan rsx:man <topic>  # Framework documentation
 php artisan list rsx          # All commands
 ```
 
 **Topics**: bundle_api, jqhtml, routing, migrations, console_debug, model_fetch, vs_code_extension, deployment, framework_divergences
 
+---
+
+## PROJECT DOCUMENTATION
+
+Project-specific technical documentation lives in `/rsx/resource/man/`. These are man-page-style text files documenting features specific to your application that build on or extend the framework.
+
+**When to create a project man page**:
+- Feature has non-obvious implementation details
+- Multiple components interact in ways that need explanation
+- Configuration options or patterns need documentation
+- AI agents or future developers need reference material
+
+**Format**: Plain text files (`.txt`) following Unix man page conventions. See `/rsx/resource/man/CLAUDE.md` for writing guidelines.
+
 **Remember**: RSpade prioritizes simplicity and rapid development. When in doubt, choose the straightforward approach.