Skip to content

docs(#98): add Storybook how-to for app developers and contributors - #104

Merged
ndorin merged 3 commits into
mainfrom
feature/98-storybook-docs
Aug 26, 2026
Merged

ndorin merged 3 commits into
mainfrom
feature/98-storybook-docs

Conversation

@jkdevito

Copy link
Copy Markdown
Contributor

Summary

Adds Storybook documentation for app developers and contributors.

  • docs/storybook-app-dev.md — how-to guide for app developers using Storybook
  • docs/storybook-contributors.md — guide for contributors extending Storybook setup

Closes #98

🤖 Generated with Claude Code

Explains how to use Storybook to render components with mock data
without needing Essentials or a Crestron processor, and how to inject
state into the Redux store (via devicesActions.setDeviceState /
roomsActions.setRoomState) as though it were sent from Essentials,
including replaying a captured real session.

Storybook is not currently configured anywhere in this repo; these
docs establish the pattern for consuming apps and flag the one real
library gap it runs into (slice reducers aren't part of the public
export surface yet).

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Copilot AI lite review requested due to automatic review settings August 17, 2026 18:45

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Adds new Storybook documentation intended to help (1) app developers render mobile-control-react-app-core components against mocked Redux/WebSocket data and (2) contributors understand library-side gaps that currently make that workflow harder.

Changes:

  • Adds an app-developer “how-to” for using Storybook with mocked Redux state (and guidance to avoid MobileControlProvider / the singleton store).
  • Adds contributor notes describing the current reducer-export gap and a potential createMockStore factory approach for the library.

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 2 comments.

File Description
docs/storybook-app-dev.md App-developer guide for Storybook usage with mock Redux state and session replay patterns.
docs/storybook-contributors.md Contributor-facing notes on library-side export gaps and suggested improvements to support the app-dev Storybook workflow.

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

Comment thread docs/storybook-app-dev.md Outdated
Comment thread docs/storybook-contributors.md
Add documentation explaining how to create a per-story Redux store and import RootState to ensure isolation and proper typing in Storybook stories.
@jkdevito jkdevito self-assigned this Aug 17, 2026
@jkdevito
jkdevito requested a review from ndorin August 26, 2026 13:29
@ndorin
ndorin merged commit 484707d into main Aug 26, 2026
3 checks passed
@ndorin
ndorin deleted the feature/98-storybook-docs branch August 26, 2026 15:21
@github-actions

Copy link
Copy Markdown

🎉 This PR is included in version 1.25.0-add-zoom.3 🎉

The release is available on:

Your semantic-release bot 📦🚀

@github-actions

Copy link
Copy Markdown

🎉 This PR is included in version 1.24.1-cache-busting.1 🎉

The release is available on:

Your semantic-release bot 📦🚀

@github-actions

Copy link
Copy Markdown

🎉 This PR is included in version 1.25.0 🎉

The release is available on:

Your semantic-release bot 📦🚀

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

HOW TO: How to use Storybook to develop React Apps

3 participants