simplify and expand on documentation

Author: dannyhw

CLAUDE.md

@@ -2,84 +2,63 @@
 
 This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
 
-## Common Development Commands
-
-### Initial Setup
+## Development Commands
 
 ```bash
+# Initial Setup
 yarn install
 yarn build
-```
 
-### Development
+# Development
+yarn dev        # Watch all packages for changes
+yarn example    # Run the expo example app with Storybook
 
-```bash
-# Watch all packages for changes
-yarn dev
-
-# Run the expo example app with Storybook
-yarn example
-```
+# Testing
+yarn test       # Run unit tests across all packages
 
-### Testing
-
-```bash
-# Run unit tests across all packages
-yarn test
-
-# Run tests in CI mode
-yarn test:ci
+# Code Quality
+yarn lint       # Run ESLint across the codebase
 
+# Documentation (from docs/ directory)
+cd docs
+yarn start      # Start development server
+yarn build      # Build documentation
+yarn serve      # Serve built documentation
 ```
 
-### Linting and Code Quality
-
-```bash
-# Run ESLint across the codebase
-yarn lint
-```
-
-### Release Process
+## Architecture Overview
 
-```bash
-# Version packages (maintainers only)
-yarn version-packages
+**Yarn workspaces monorepo** managed by Lerna containing React Native Storybook packages.
 
-# Publish to npm
-yarn publish:latest  # For stable releases
-yarn publish:next    # For pre-releases
-yarn publish:alpha   # For alpha releases
-```
+### Packages
 
-## Architecture Overview
+**Apps**
 
-This is a **Yarn workspaces monorepo** managed by Lerna containing React Native Storybook packages:
+- examples/expo-example - Expo example app showcasing Storybook
+- docs - Documentation site for Storybook React Native
 
-### Core Packages
+**Core:**
 
-- **@storybook/react-native** - Main package providing Storybook functionality for React Native
-- **@storybook/react-native-ui** - Full UI components for on-device Storybook
-- **@storybook/react-native-ui-lite** - Lightweight UI components
-- **@storybook/react-native-ui-common** - Shared UI components
-- **@storybook/react-native-theming** - Theming utilities
+- `@storybook/react-native` - Main package providing Storybook functionality
+- `@storybook/react-native-ui` - Full UI components for on-device Storybook
+- `@storybook/react-native-ui-lite` - Lightweight UI components
+- `@storybook/react-native-ui-common` - Shared UI components
+- `@storybook/react-native-theming` - Theming utilities
 
-### On-Device Addons
+**On-Device Addons:**
 
-- **@storybook/addon-ondevice-actions** - Log component interactions
-- **@storybook/addon-ondevice-backgrounds** - Change story backgrounds
-- **@storybook/addon-ondevice-controls** - Dynamically edit component props
-- **@storybook/addon-ondevice-notes** - Add markdown documentation to stories
+- `@storybook/addon-ondevice-actions` - Log component interactions
+- `@storybook/addon-ondevice-backgrounds` - Change story backgrounds
+- `@storybook/addon-ondevice-controls` - Dynamically edit component props
+- `@storybook/addon-ondevice-notes` - Add markdown documentation to stories
 
-### Build System
+### Build System & Metro Configuration
 
-- Uses **tsup** for TypeScript compilation
-- Targets ES2022 with CommonJS output
+- Uses **tsup** for TypeScript compilation (ES2022, CommonJS output)
 - Each package has its own `tsup.config.ts`
-- Running `yarn prepare` in a package builds it
-
-### Metro Configuration
+- `yarn prepare` in a package builds it
 
-The `withStorybook` wrapper is crucial for React Native Storybook:
+The `withStorybook` Metro wrapper:
 
 - Enables `unstable_allowRequireContext` for dynamic story imports
 - Automatically generates `storybook.requires.ts` file
@@ -88,8 +67,8 @@ The `withStorybook` wrapper is crucial for React Native Storybook:
 
 ### Key Concepts
 
-1. **CSF (Component Story Format)**: Standard story syntax used across Storybook
-2. **On-device UI**: Native UI that runs directly on mobile devices
-3. **Story requires generation**: Automatic generation of story imports via Metro
-4. **Portable stories**: Reuse stories in unit tests
-5. **WebSocket support**: Remote control stories from external devices
+1. **CSF (Component Story Format)** - Standard story syntax
+2. **On-device UI** - Native UI that runs directly on mobile devices
+3. **Story requires generation** - Automatic generation of story imports via Metro
+4. **Portable stories** - Reuse stories in unit tests
+5. **WebSocket support** - Remote control stories from external devices