@jmruthers/pace-core 0.2.4

package/docs/INDEX.md

@@ -0,0 +1,192 @@
+# PACE Core Documentation Index
+
+> **📚 Complete Documentation Reference** | [Quick Start](./getting-started/quick-start.md) | [API Reference](./api-reference/components.md) | [Troubleshooting](./troubleshooting/README.md)
+
+Complete index of all PACE Core documentation organized by topic and use case.
+
+## 🚀 Getting Started
+
+### First Time Users
+- **[Installation](./getting-started/installation.md)** - Package installation and basic setup
+- **[Quick Start](./getting-started/quick-start.md)** - Build your first app in 10 minutes
+- **[Examples](./getting-started/examples/README.md)** - Complete working examples
+
+### Configuration
+- **[Vite Configuration](./consuming-app-vite-config.md)** - **CRITICAL** Tailwind v4 setup
+- **[Environment Setup](./getting-started/environment-setup.md)** - Environment variables
+- **[Build Configuration](./getting-started/build-configuration.md)** - Build tool setup
+
+## 🏗️ Core Features
+
+### Authentication & Security
+- **[Authentication Overview](./core-concepts/authentication.md)** - User management and sessions
+- **[RBAC System](./rbac/README.md)** - Role-based access control
+- **[Security Best Practices](./best-practices/security.md)** - Security guidelines
+- **[Permission Enforcement](./implementation-guides/permission-enforcement.md)** - Implementing permissions
+
+### Data Management
+- **[Data Tables](./implementation-guides/data-tables.md)** - Interactive data management
+- **[Forms](./implementation-guides/forms.md)** - Form handling and validation
+- **[Event Management](./core-concepts/event-management.md)** - Event selection and context
+- **[Organisation Management](./core-concepts/organisation-management.md)** - Multi-tenant support
+- **[Public Pages](./implementation-guides/public-pages.md)** - **NEW** Public pages without authentication
+
+### UI & Layout
+- **[Components API](./api-reference/components.md)** - Complete component reference
+- **[App Layout](./implementation-guides/app-layout.md)** - Application structure
+- **[Navigation](./implementation-guides/navigation.md)** - Navigation patterns
+- **[Print Components](./print-components/README.md)** - Print-optimized layouts
+
+## 🎨 Styling & Theming
+
+### Design System
+- **[Styling Overview](./styles/README.md)** - Complete design system
+- **[Color Palettes](./styles/color-palettes.md)** - Main, secondary, accent colors
+- **[Typography](./styles/typography.md)** - Font families and text styles
+- **[Component Styling](./styles/component-styling.md)** - How components are styled
+
+### Customization
+- **[Custom Themes](./styles/custom-themes.md)** - Creating custom themes
+- **[Dynamic Theming](./styles/dynamic-theming.md)** - Runtime theme switching
+- **[CSS Architecture](./styles/css-architecture.md)** - Single-file CSS approach
+
+## 🔧 API Reference
+
+### Components
+- **[UI Components](./api-reference/components.md)** - Button, Card, Input, etc.
+- **[Data Components](./api-reference/components.md#data-table)** - DataTable, Form, etc.
+- **[Layout Components](./api-reference/components.md#layout-components)** - PaceAppLayout, Header, etc.
+- **[Print Components](./api-reference/components.md#print-components)** - Print-optimized components
+
+### Hooks & Utilities
+- **[React Hooks](./api-reference/hooks.md)** - useUnifiedAuth, useCan, etc.
+- **[RBAC Hooks](./rbac/README.md#hooks)** - Permission checking hooks
+- **[Utilities](./api-reference/utilities.md)** - Helper functions
+
+## 🎯 Best Practices
+
+### Development
+- **[Best Practices Overview](./best-practices/README.md)** - Comprehensive guide
+- **[Performance](./best-practices/performance.md)** - Optimization strategies
+- **[Testing](./best-practices/testing.md)** - Testing patterns
+- **[Code Quality](./best-practices/README.md#code-quality)** - TypeScript, organization
+
+### Production
+- **[Deployment](./best-practices/deployment.md)** - Production deployment
+- **[Security](./best-practices/security.md)** - Security guidelines
+- **[Monitoring](./best-practices/README.md#monitoring)** - Performance monitoring
+
+## 🐛 Troubleshooting
+
+### Common Issues
+- **[Troubleshooting Overview](./troubleshooting/README.md)** - Complete guide
+- **[Common Issues](./troubleshooting/common-issues.md)** - Frequent problems
+- **[Styling Issues](./troubleshooting/styling-issues.md)** - Component styling
+- **[Authentication Issues](./troubleshooting/authentication-issues.md)** - Auth problems
+
+### Debugging
+- **[Debugging Guide](./troubleshooting/debugging.md)** - Debug techniques
+- **[Performance Issues](./troubleshooting/performance-issues.md)** - Performance problems
+- **[Build Issues](./troubleshooting/build-issues.md)** - Build and deployment
+
+## 🔄 Migration & Updates
+
+### Version Updates
+- **[Migration Overview](./migration/README.md)** - Upgrade guides
+- **[v0.4.17 Source Path Fix](./migration/v0.4.17-source-path-fix.md)** - **CRITICAL** Fix
+- **[v0.4.16 CSS-First Migration](./migration/v0.4.16-css-first-approach.md)** - Simplified config
+- **[v0.4.15 Tailwind Scanning](./migration/v0.4.15-tailwind-scanning.md)** - Legacy approach
+
+### Breaking Changes
+- **[v0.x to v1.x](./migration/v0-to-v1.md)** - Major version upgrade
+- **[RBAC Migration](./migration/rbac-migration.md)** - RBAC system updates
+- **[Component Updates](./migration/component-updates.md)** - Component API changes
+
+## 📖 Core Concepts
+
+### Understanding PACE Core
+- **[Architecture](./architecture/README.md)** - System architecture
+- **[Design Principles](./core-concepts/design-principles.md)** - Core design philosophy
+- **[Security Model](./core-concepts/security-model.md)** - Security architecture
+- **[Performance Model](./core-concepts/performance-model.md)** - Performance considerations
+
+### Key Concepts
+- **[Permissions](./core-concepts/permissions.md)** - Permission system
+- **[Events](./core-concepts/events.md)** - Event management
+- **[Organisations](./core-concepts/organisations.md)** - Multi-tenancy
+- **[Context Management](./core-concepts/context-management.md)** - React context usage
+
+## 🛠️ Implementation Guides
+
+### Application Structure
+- **[App Layout](./implementation-guides/app-layout.md)** - Layout patterns
+- **[Navigation](./implementation-guides/navigation.md)** - Navigation systems
+- **[Routing](./implementation-guides/routing.md)** - URL routing
+- **[State Management](./implementation-guides/state-management.md)** - Application state
+
+### Data & Forms
+- **[Data Tables](./implementation-guides/data-tables.md)** - Data management
+- **[Forms](./implementation-guides/forms.md)** - Form implementation
+- **[Validation](./implementation-guides/validation.md)** - Input validation
+- **[File Upload](./implementation-guides/file-upload.md)** - File handling
+
+### Advanced Features
+- **[Permission Enforcement](./implementation-guides/permission-enforcement.md)** - Security implementation
+- **[Event Management](./implementation-guides/event-management.md)** - Event handling
+- **[Organisation Management](./implementation-guides/organisation-management.md)** - Multi-tenancy
+- **[Print Reports](./implementation-guides/print-reports.md)** - Report generation
+
+## 🎨 Styling Guides
+
+### Design System
+- **[Design Tokens](./styles/design-tokens.md)** - Design system tokens
+- **[Color System](./styles/color-system.md)** - Color management
+- **[Typography](./styles/typography.md)** - Text styling
+- **[Spacing](./styles/spacing.md)** - Layout spacing
+
+### Customization
+- **[Theme Customization](./styles/theme-customization.md)** - Custom themes
+- **[Component Customization](./styles/component-customization.md)** - Styling components
+- **[CSS Architecture](./styles/css-architecture.md)** - CSS organization
+- **[Responsive Design](./styles/responsive-design.md)** - Mobile-first approach
+
+## 🔍 Search by Use Case
+
+### I want to...
+- **Build a new app** → [Quick Start](./getting-started/quick-start.md)
+- **Add authentication** → [Authentication Guide](./core-concepts/authentication.md)
+- **Implement permissions** → [RBAC System](./rbac/README.md)
+- **Create data tables** → [Data Tables Guide](./implementation-guides/data-tables.md)
+- **Style my app** → [Styling Overview](./styles/README.md)
+- **Fix styling issues** → [Troubleshooting - Styling](./troubleshooting/styling-issues.md)
+- **Optimize performance** → [Performance Best Practices](./best-practices/performance.md)
+- **Deploy to production** → [Deployment Guide](./best-practices/deployment.md)
+- **Migrate from v0.x** → [Migration Guide](./migration/README.md)
+- **Debug an issue** → [Troubleshooting Overview](./troubleshooting/README.md)
+
+### I'm looking for...
+- **Component documentation** → [Components API](./api-reference/components.md)
+- **Hook reference** → [Hooks API](./api-reference/hooks.md)
+- **Code examples** → [Examples](./getting-started/examples/README.md)
+- **Best practices** → [Best Practices](./best-practices/README.md)
+- **Security guidelines** → [Security Best Practices](./best-practices/security.md)
+- **Performance tips** → [Performance Best Practices](./best-practices/performance.md)
+- **Testing strategies** → [Testing Best Practices](./best-practices/testing.md)
+
+## 📚 Additional Resources
+
+### External Links
+- **[Supabase Documentation](https://supabase.com/docs)** - Backend services
+- **[Tailwind CSS Documentation](https://tailwindcss.com/docs)** - CSS framework
+- **[React Documentation](https://react.dev)** - React framework
+- **[TypeScript Documentation](https://www.typescriptlang.org/docs)** - Type system
+
+### Community
+- **[GitHub Repository](https://github.com/jmruthers/pace-core)** - Source code
+- **[Issue Tracker](https://github.com/jmruthers/pace-core/issues)** - Bug reports
+- **[Discussions](https://github.com/jmruthers/pace-core/discussions)** - Community help
+- **[Changelog](./CHANGELOG.md)** - Version history
+
+---
+
+**Need help?** Check the [Troubleshooting Guide](./troubleshooting/README.md) or [ask for help](https://github.com/jmruthers/pace-core/discussions).

package/docs/README.md

@@ -0,0 +1,165 @@
+# @jmruthers/pace-core
+
+> **⚡ Get Started in 5 Minutes** | [📚 Complete Index](./INDEX.md) | [Quick Reference](./quick-reference.md) | [Examples](./getting-started/examples/)
+
+A comprehensive React component library with built-in authentication, RBAC, and event management.
+
+> **📚 New to PACE Core?** Start with the [Complete Documentation Index](./INDEX.md) for a comprehensive overview of all available documentation.
+
+## ⚡ Quick Start
+
+```bash
+npm install @jmruthers/pace-core
+```
+
+```tsx
+import { UnifiedAuthProvider, DataTable } from '@jmruthers/pace-core';
+
+// Import the core CSS file
+import '@jmruthers/pace-core/styles/core.css';
+
+function App() {
+  return (
+    <UnifiedAuthProvider>
+      <DataTable data={[]} columns={[]} />
+    </UnifiedAuthProvider>
+  );
+}
+```
+
+### 🎯 **Start Here**
+- **[Quick Reference](./quick-reference.md)** - Single-page reference for common tasks
+- **[Installation](./getting-started/installation.md)** - 5 min setup
+- **[Quick Start](./getting-started/quick-start.md)** - Build your first app
+- **[Examples](./getting-started/examples/)** - Complete working examples
+
+## 🚀 **NEW: v0.4.17 Source Path Fix**
+
+**Important**: v0.4.17 fixes the @source directive paths for proper Tailwind v4 content scanning.
+
+- **[Source Path Fix Guide](./migration/v0.4.17-source-path-fix.md)** - **CRITICAL** Fix for @source directive paths
+- **[CSS-First Migration Guide](./migration/v0.4.16-css-first-approach.md)** - Simplified configuration
+- **[Legacy Migration Guide](./migration/v0.4.15-tailwind-scanning.md)** - For v0.4.15 source file approach
+- **[Tailwind Content Scanning](./troubleshooting/tailwind-content-scanning.md)** - Comprehensive scanning solutions
+
+## 📚 Documentation
+
+### 🔧 **Core Features**
+- **[Authentication](./core-concepts/authentication.md)** - User management and session handling
+- **[RBAC System](./rbac/README.md)** - Complete role-based access control
+- **[UI Components](./api-reference/components.md)** - Modern, accessible component library
+- **[Print Components](./print-components/README.md)** - **NEW** Print-optimized layout system
+- **[Styling](./styles/README.md)** - Design system and theming
+
+### 🛠️ **Implementation**
+- **[App Layout](./implementation-guides/app-layout.md)** - Application structure and layouts
+- **[Data Tables](./implementation-guides/data-tables.md)** - Interactive data management
+- **[Forms](./implementation-guides/forms.md)** - Form handling and validation
+- **[Navigation](./implementation-guides/navigation.md)** - Navigation patterns and routing
+- **[Public Pages](./implementation-guides/public-pages.md)** - **NEW** Public pages without authentication
+- **[Permission Enforcement](./implementation-guides/permission-enforcement.md)** - Security implementation
+
+### 📖 **Core Concepts**
+- **[Permissions](./core-concepts/permissions.md)** - Permission checking and enforcement
+- **[Events](./core-concepts/events.md)** - Event management and selection
+- **[Organisations](./core-concepts/organisations.md)** - Multi-tenant organisation management
+- **[Security](./core-concepts/security.md)** - Security-first design principles
+
+### 🎨 **Styling & Theming**
+- **[Design System](./styles/README.md)** - Complete design system overview
+- **[Color Palettes](./styles/color-palettes.md)** - Main, secondary, and accent colors
+- **[Typography](./styles/typography.md)** - Font families and text styles
+- **[Component Styling](./styles/component-styling.md)** - How components are styled
+- **[Custom Themes](./styles/custom-themes.md)** - Creating custom themes
+
+### 🔧 **Configuration**
+- **[Vite Configuration](./consuming-app-vite-config.md)** - **CRITICAL** Tailwind scanning setup
+- **[Environment Setup](./getting-started/environment-setup.md)** - Environment variables and configuration
+- **[Build Configuration](./getting-started/build-configuration.md)** - Build tool configuration
+- **[Deployment](./getting-started/deployment.md)** - Production deployment guide
+
+### 🎯 **Best Practices**
+- **[Best Practices Overview](./best-practices/README.md)** - Comprehensive best practices guide
+- **[Security](./best-practices/security.md)** - Security best practices and guidelines
+- **[Performance](./best-practices/performance.md)** - Performance optimization strategies
+- **[Testing](./best-practices/testing.md)** - Testing strategies and patterns
+- **[Deployment](./best-practices/deployment.md)** - Deployment guidelines and best practices
+
+### 🐛 **Troubleshooting**
+- **[Troubleshooting Overview](./troubleshooting/README.md)** - Complete troubleshooting guide
+- **[Common Issues](./troubleshooting/common-issues.md)** - Frequently encountered problems
+- **[Styling Issues](./troubleshooting/styling-issues.md)** - Fix component styling problems
+- **[Tailwind Content Scanning](./troubleshooting/tailwind-content-scanning.md)** - **NEW** Comprehensive scanning solutions
+- **[Authentication Issues](./troubleshooting/authentication-issues.md)** - Auth-related problems
+- **[Database Issues](./troubleshooting/database-issues.md)** - Database connection and setup
+- **[Organisation Context Setup](./troubleshooting/organisation-context-setup.md)** - Database setup for organisation context
+- **[Debugging](./troubleshooting/debugging.md)** - Debugging techniques and tools
+
+## 🎨 Features
+
+- **🔐 Authentication** - Built-in Supabase authentication with RBAC
+- **📅 Event Management** - Complete event access control and management system
+- **🎨 UI Components** - Modern, accessible components with Tailwind CSS
+- **📱 Responsive** - Mobile-first design
+- **♿ Accessible** - WCAG 2.1 AA compliant
+- **🎯 TypeScript** - Full TypeScript support
+- **🧪 Tested** - Comprehensive test coverage
+- **🔒 Secure** - Security-first design
+
+## 🏗️ Architecture
+
+```mermaid
+graph TD
+    A[Your App] --> B[UnifiedAuthProvider]
+    B --> C[Supabase Auth]
+    B --> D[RBAC System]
+    A --> E[UI Components]
+    E --> F[Tailwind CSS]
+    E --> G[Accessibility]
+```
+
+For detailed architecture information, see the [PACE Core Architecture Guide](./architecture/README.md).
+
+## 📦 What's Included
+
+### Authentication & Events
+- `UnifiedAuthProvider` - Complete auth provider with event access
+- `EventProvider` - Event management and selection
+- `useAuthWorkflow` - Auth state management
+- `useEvents` - Event access and management
+- `useUnifiedAuth` - Combined auth and event access
+- `useCan` - Permission checking (from `@jmruthers/pace-core`)
+- `usePermissions` - Get all permissions (from `@jmruthers/pace-core`)
+
+### UI Components
+- `Button` - Various button variants
+- `DataTable` - Full-featured data table
+- `Form` - Form components with validation
+- `Modal` - Modal dialogs
+- `Select` - Dropdown selectors
+- And many more...
+
+### Utilities
+- `useToast` - Toast notifications
+- `useDebounce` - Debounced values
+- `useZodForm` - Form validation
+
+## 🔧 Development
+
+```bash
+# Install dependencies
+npm install
+
+# Start development server
+npm run dev
+
+# Run tests
+npm test
+
+# Build package
+npm run build
+```
+
+## 📄 License
+
+MIT License - see [LICENSE](../../LICENSE) for details.

package/docs/api/.nojekyll

@@ -0,0 +1 @@
+TypeDoc added this file to prevent GitHub Pages from using Jekyll. You can turn off this behavior by setting the `githubPages` option to false.

package/docs/api/README.md

@@ -0,0 +1,301 @@
+@jmruthers/pace-core / [Exports](modules.md)
+
+# @jmruthers/pace-core
+
+Clean, modern React component library with Tailwind v4 styling and native utilities.
+
+## 🚀 PaceAppLayout Usage
+
+**PaceAppLayout uses React Router's nested routing pattern for optimal performance and scalability.**
+
+```tsx
+// ✅ Correct usage with React Router
+<Router>
+  <Routes>
+    <Route path="/" element={<PaceAppLayout appName="My App" />}>
+      <Route path="dashboard" element={<Dashboard />} />
+      <Route path="settings" element={<Settings />} />
+    </Route>
+  </Routes>
+</Router>
+```
+
+## 🚀 Complete Installation Guide
+
+### 1. Install Dependencies
+
+```bash
+# Install pace-core and required peer dependencies
+npm install @jmruthers/pace-core @tanstack/react-table @radix-ui/react-checkbox @radix-ui/react-dialog @radix-ui/react-dropdown-menu @radix-ui/react-label @radix-ui/react-slot lucide-react class-variance-authority clsx tailwind-merge
+
+# Install Tailwind CSS v4 and Vite plugin
+npm install -D @tailwindcss/vite tailwindcss@^4.0.0
+```
+
+### 2. Import Core Styles
+
+```tsx
+// src/main.tsx (or your app's entry point)
+import '@jmruthers/pace-core/styles/core.css';
+import React from 'react';
+import ReactDOM from 'react-dom/client';
+import App from './App';
+
+const root = ReactDOM.createRoot(document.getElementById('root') as HTMLElement);
+root.render(
+  <React.StrictMode>
+    <App />
+  </React.StrictMode>
+);
+```
+
+### 3. Configure Vite with Tailwind v4
+
+**NEW in v0.4.17+:** Pace-core uses Tailwind v4's CSS-first approach with corrected `@source` directives. This automatically scans the published source files without requiring complex Vite configuration.
+
+```typescript
+// vite.config.ts
+import { defineConfig } from 'vite'
+import react from '@vitejs/plugin-react'
+import tailwindcss from '@tailwindcss/vite'
+import path from 'path'
+
+export default defineConfig({
+  plugins: [
+    react(),
+    tailwindcss({
+      // Only need to scan your app's source files
+      // pace-core source files are automatically scanned via @source directives
+      content: [
+        './src/**/*.{js,ts,jsx,tsx}'
+      ]
+    })
+  ],
+  resolve: {
+    alias: {
+      "@": path.resolve(__dirname, "./src"),
+    },
+  },
+  server: {
+    port: 3000,
+    open: true,
+  },
+  build: {
+    outDir: 'dist',
+    sourcemap: true,
+  },
+})
+```
+
+**Fallback Configuration:** If the CSS-first approach doesn't work, you can explicitly include pace-core source files:
+
+```typescript
+// vite.config.ts - Fallback configuration
+export default defineConfig({
+  plugins: [
+    react(),
+    tailwindcss({
+      content: [
+        './src/**/*.{js,ts,jsx,tsx}',
+        './node_modules/@jmruthers/pace-core/src/**/*.{js,ts,jsx,tsx}'
+      ]
+    })
+  ],
+  // ... rest of config
+})
+```
+
+### 4. Verify Installation
+
+Create a test component to ensure everything works:
+
+```tsx
+// src/App.tsx
+import { Button, Card, Input } from '@jmruthers/pace-core';
+
+function App() {
+  return (
+    <div className="p-8 space-y-4">
+      <h1 className="text-2xl font-bold text-main-900">PACE Core Test</h1>
+      
+      <Card className="p-4">
+        <h2 className="text-lg font-semibold text-sec-800 mb-2">Components Test</h2>
+        <div className="space-y-2">
+          <Button variant="primary" className="bg-main-600 text-main-50">
+            Primary Button
+          </Button>
+          <Button variant="secondary" className="bg-sec-500 text-main-50">
+            Secondary Button
+          </Button>
+          <Input placeholder="Test input field" className="border-main-300" />
+        </div>
+      </Card>
+    </div>
+  );
+}
+
+export default App;
+```
+
+**Expected Result:** You should see properly styled components with PACE Core's design system colors and typography.
+
+## ⚠️ Critical Configuration Notes
+
+### Why Source File Scanning is Required
+
+Pace-core v0.4.15+ includes source files in the published package because:
+
+- Tailwind v4 needs to scan original TypeScript/JSX files to detect utility classes
+- Compiled JavaScript files don't contain the class names Tailwind needs
+- Without proper scanning, only ~292 CSS rules are generated instead of 800+ needed
+
+### Alternative Configuration (if source files don't work)
+
+If you're still having issues with component scanning:
+
+```typescript
+// vite.config.ts
+import { defineConfig } from 'vite'
+import react from '@vitejs/plugin-react'
+import tailwindcss from '@tailwindcss/vite'
+
+export default defineConfig({
+  plugins: [
+    react(),
+    tailwindcss({
+      content: [
+        './src/**/*.{js,ts,jsx,tsx}',
+        // Try source files first
+        './node_modules/@jmruthers/pace-core/src/**/*.{js,ts,jsx,tsx}',
+        // Fallback: also scan dist files
+        './node_modules/@jmruthers/pace-core/dist/**/*.{js,ts,jsx,tsx}'
+      ]
+    })
+  ],
+})
+```
+
+### Legacy Configuration (v0.4.14 and below)
+
+For older versions, use this configuration:
+
+```typescript
+// vite.config.ts
+export default defineConfig({
+  plugins: [
+    react(),
+    tailwindcss({
+      content: [
+        './src/**/*.{js,ts,jsx,tsx}',
+        './node_modules/@jmruthers/pace-core/**/*.{js,ts,jsx,tsx}'
+      ]
+    })
+  ],
+})
+```
+
+## 🔍 Troubleshooting
+
+### Issue: Only 292 CSS rules instead of 800+
+
+**Solution**: 
+1. Update to pace-core v0.4.15+
+2. Use source file paths: `./node_modules/@jmruthers/pace-core/src/**/*.{js,ts,jsx,tsx}`
+3. Clear build cache: `rm -rf dist .vite node_modules && npm install`
+
+### Issue: Components appear unstyled
+
+**Solution**: 
+1. Check your Vite configuration includes pace-core source files
+2. Ensure CSS file is imported: `import '@jmruthers/pace-core/styles/core.css'`
+3. Restart dev server after configuration changes
+
+### Issue: Build errors with source files
+
+**Solution**: Add TypeScript configuration for node_modules:
+
+```json
+// tsconfig.json
+{
+  "compilerOptions": {
+    "skipLibCheck": true
+  }
+}
+```
+
+## Features
+
+- 🎨 **Complete Design System** - Colors, typography, spacing, shadows
+- 🧩 **React Components** - Buttons, inputs, cards, data tables, and more
+- 🔐 **RBAC System** - Role-based access control with Supabase
+- 🎨 **Tailwind v4** - CSS-first approach with design tokens
+- 📱 **Responsive** - Mobile-first design patterns
+- ♿ **Accessible** - WCAG compliant components
+- 🚀 **Performance** - Tree-shakeable, optimized bundle
+
+## Documentation
+
+- [Quick Start Guide](./docs/getting-started/quick-start.md) - Complete step-by-step tutorial
+- [Installation Guide](./docs/getting-started/installation.md) - Detailed setup instructions
+- [Vite Configuration](./docs/consuming-app-vite-config.md) - **CRITICAL** Tailwind scanning setup
+- [Component API](./docs/api/README.md) - All available components and hooks
+- [Styling Guide](./docs/styles/README.md) - Understanding the design system
+- [Troubleshooting](./docs/troubleshooting/styling-issues.md) - Fix common styling problems
+- [Tailwind Content Scanning](./docs/troubleshooting/tailwind-content-scanning.md) - **NEW** Comprehensive scanning solutions
+
+## Import Strategy
+
+PACE Core provides two import paths to optimize for different use cases:
+
+### Main Export (Recommended for Common Components)
+
+Use the main export for frequently used components and utilities:
+
+```typescript
+import { 
+  Button, 
+  Card, 
+  Input, 
+  DropdownMenu, 
+  Select, 
+  Dialog,
+  useUnifiedAuth 
+} from '@jmruthers/pace-core';
+```
+
+**Available from main export:**
+- **Basic UI**: Button, Card, Input, Label, Alert, Avatar, Checkbox, Progress
+- **Advanced UI**: Dialog (with HTML content), DropdownMenu, Select, Toast, Tooltip
+- **Data Display**: DataTable (with hierarchical actions & expand/collapse all), Table
+- **Forms**: Form, LoginForm
+- **Layout**: PaceAppLayout, Header, Footer, NavigationMenu
+- **Print Components**: PrintLayout, PrintDataTable, PrintCard, PrintHeader, PrintText, PrintButton, PrintGrid, PrintSection, PrintFooter, PrintPageBreak
+- **Providers**: UnifiedAuthProvider, OrganisationProvider, EventProvider
+- **Hooks**: useUnifiedAuth, useOrganisations, useEvents
+
+### Component Documentation
+
+- **[DataTable Component](docs/implementation-guides/data-tables.md)** - Enterprise-grade data table with hierarchical rows, expand/collapse all, actions, sorting, filtering, and performance optimization
+  - **[Hierarchical DataTable Guide](docs/implementation-guides/hierarchical-datatable.md)** - Complete guide for implementing parent/child rows with expand/collapse all and smart sorting
+- **[Print Components](docs/print-components/README.md)** - **NEW** Print-optimized layout system for reports, documents, and printable content
+  - **[Print Quick Start](docs/print-components/quick-start.md)** - 5-minute setup guide
+  - **[Print API Reference](docs/print-components/api-reference.md)** - Complete component documentation
+- **[Dialog Component](src/components/Dialog/README.md)** - Comprehensive dialog system with smart height management, scrolling, HTML content rendering, and accessibility features
+- **[Storage System](src/utils/storage/README.md)** - File storage utilities with organization-scoped access control
+
+### Complete Components Export (For Specialized Components)
+
+Use the complete export for specialized or advanced components:
+
+```typescript
+import { 
+  DataTable, 
+  NavigationMenu,
+  FormField,
+  FormErrorSummary 
+} from '@jmruthers/pace-core/components';
+```
+
+## License
+
+MIT License - see [LICENSE](./LICENSE) for details.