The static class property singleton pattern doesn't survive HMR
when module boundaries get crossed. New dials would register with
a fresh registry instance while DialsOverlay stayed subscribed to
the old one.
Fix: Store the singleton on `window.__NITESHIFT_DIALS_REGISTRY__`
so it persists across module re-evaluations during hot reload.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
Introduces a complete design dials system that allows designers and PMs
to adjust UI parameters at runtime without code changes.
**Dials SDK (`packages/dials/`):**
- useDynamicColor: Color values with design system integration
- useDynamicSpacing: Spacing/padding/margin controls
- useDynamicVariant: Discrete choice selections
- useDynamicBoolean: Toggle/feature flag controls
- useDynamicNumber: Numeric values with min/max/step
- DialsOverlay: Compact Leva-inspired UI (Ctrl+D to toggle)
- DialsProvider: React context for dial state management
- Design manifest integration for design system tokens
**App Integration:**
- Added DialsProvider to app Providers
- Example dials on WebsitePage (metrics bar, panels, navigation)
- MetricCard component with adjustable typography dials
- TypeScript manifest at src/config/niteshift-manifest.ts
**Documentation:**
- Comprehensive CLAUDE.md section on dials usage
- Best practices for preserving original appearance
- Examples for all dial types
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
The 60-second polling loop that waits for the dev server to respond
adds unnecessary setup time. The warmup step that follows already has
a timeout, so we can proceed directly to it.
Add --package-import-method=copy to all pnpm install commands in niteshift-setup.sh.
This ensures packages are copied instead of hard-linked, which is required for
proper functionality in Modal's containerized environment where hard links don't
work across filesystem layers.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
Add a curl request to / after the dev server is ready to pre-compile the main application routes. This triggers Next.js compilation on first access during setup rather than on first user interaction, significantly improving the initial user experience by avoiding 5-10 second compilation delays.
The warm-up is non-blocking - if it fails or times out, the setup continues successfully and routes will compile on first user access as before.
Set ZenProvider to use theme="light" to ensure consistent light mode
across all contexts regardless of system preferences or iframe embedding.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
Configure ZenProvider to use colorScheme="system" to consistently respect
OS/browser dark mode preference across all contexts including iframes.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
This file provides guidance to Claude Code when working in the repository.
Key sections include:
- Niteshift sandbox configuration status
- Rapid UI prototyping guide with component library usage
- Data fetching patterns with React Query
- State management with Zustand
- Common UI patterns and code examples
- Project architecture overview
Optimized for Niteshift sandbox environment where dev server and
database are pre-configured and running.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
- Create generate-test-data.js script for generating realistic demo data
- Support for small (3 days), medium (14 days), and full (30 days) scales
- Generates realistic user sessions, pageviews, custom events, and revenue
- Includes geographic diversity, device variety, and traffic source distributions
- Implements proper UTM campaign tracking and conversion funnels
- Uses direct Prisma writes for performance (~10k sessions in 5 minutes)
- Add npm script: 'generate-test-data' for easy execution
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
Move navigation logic from render to useEffect to prevent React warning
about state updates during render. Use ref to track redirect state and
handle both cloud mode (window.location.assign) and standard mode
(router.replace) navigation.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
* feat: add niteshift setup script for umami application
* refactor: switch dev setup to use dev server with hot reload instead of production build
* feat: add unified logging to development server output
Allow dev server logs to be written to both /tmp/umami-server.log and NITESHIFT_LOG_FILE when configured, enabling centralized log aggregation.
* refactor: simplify dev server logging to use single log file
Consolidate dual logging logic into single append to LOG_FILE,
simplify error reporting to reference the configured log file,
and remove unnecessary /tmp/umami-server.log references.
