docs(storybook): replace welcome banner with Introduction and System Principles content#3568
Conversation
…Principles content
![cursor[bot]](https://avatars.githubusercontent.com/in/1210556?s=60&v=4){kind=small}
| @@ -1,6 +1,53 @@ | |||
| import { Meta, Unstyled } from "@storybook/addon-docs/blocks" | |||
| import { WelcomeMessage } from "./components/Welcome" | |||
| import { Meta } from "@storybook/addon-docs/blocks"; | |||
There was a problem hiding this comment.
Unused WelcomeMessage component file not cleaned up
Low Severity
The WelcomeMessage import from ./components/Welcome was removed, but packages/react/docs/components/Welcome.tsx still exists in the repo with no remaining consumers. This file is now dead code that could confuse future developers.
Additional Locations (1)
There was a problem hiding this comment.
Pull request overview
Updates the React package Storybook “Introduction” docs page to show first-party documentation content directly in Storybook instead of a welcome/redirect banner, reducing friction for developers browsing the design system.
Changes:
- Replaced the previous Welcome banner usage with “Introduction” and “System Principles” documentation content.
- Simplified the MDX imports to only what’s needed for the page metadata.
Comments suppressed due to low confidence (2)
packages/react/docs/Introduction.mdx:1
- Import line ends with a semicolon, but this package’s formatting config sets
semi: falseand most docs MDX files omit semicolons. Please remove the semicolon to match repo formatting and avoid formatter churn.
import { Meta } from "@storybook/addon-docs/blocks";
packages/react/docs/Introduction.mdx:33
- This page introduces a second H1 (
# System Principles) after the initial# Introduction. Other docs pages in this folder use a single H1 per page; having multiple H1s can confuse the Docs TOC/heading hierarchy. Consider making “System Principles” an H2 (##) and shifting the numbered principles down one level (###).
---
# System Principles
f0's principles guide how we build and use our design system to create coherent user experiences across all Factorial products.
✅ No New Circular DependenciesNo new circular dependencies detected. Current count: 0 |
📦 Alpha Package Version PublishedUse Use |
🔍 Visual review for your branch is published 🔍Here are the links to: |
🚪 Why?
Problem
The Storybook welcome page displayed a banner redirecting users to the external documentation site (f0.factorial.dev). This created friction for developers who expected to see useful information directly in Storybook.
🔑 What?
Changes
WelcomeMessageredirect banner with actual documentation content✅ Verification
Manual Verification
Note
Low Risk
Low risk documentation-only change affecting the Storybook intro page content; no runtime logic or API behavior changes.
Overview
Replaces the Storybook welcome/redirect banner on
Introduction.mdx(and removes theWelcomeMessageusage) with in-Storybook documentation content.Adds an Introduction section (what/why f0) and a System Principles section outlining five core principles, and sets the page meta title via
@storybook/addon-docs/blocksMeta.Written by Cursor Bugbot for commit 8e082d2. This will update automatically on new commits. Configure here.