Skip to content

docs: Add design system integration guides (MUI, Chakra UI, Ant Design)#223

Open
qkraudghgh wants to merge 4 commits intotoss:mainfrom
qkraudghgh:docs/with-design-systems
Open

docs: Add design system integration guides (MUI, Chakra UI, Ant Design)#223
qkraudghgh wants to merge 4 commits intotoss:mainfrom
qkraudghgh:docs/with-design-systems

Conversation

@qkraudghgh
Copy link
Copy Markdown

Description

Adds a new "디자인 시스템과 함께 쓰기 / With Design Systems" section under docs/more with runnable Sandpack examples showing how to integrate overlay-kit with popular React UI libraries.

Related Issue: N/A (proactive documentation improvement)

Changes

  • Register a new documentation section docs/more/with-design-systems in the sidebar for both ko and en locales (_meta.tsx updates).
  • Add Material UI example (mui.mdx) — Dialog with open/onClose, memory release via TransitionProps.onExited.
  • Add Chakra UI v3 example (chakra-ui.mdx) — Dialog.Root with onOpenChange, memory release via setTimeout matching the scale motion preset (Chakra v3 does not expose an exit-complete callback).
  • Add Ant Design example (ant-design.mdx) — Modal with onCancel/onOk, memory release via afterClose.
  • Each page covers three patterns consistent with existing docs: basic overlay.open, async overlay.openAsync, and memory release after the exit animation.

Motivation and Context

The existing docs demonstrate overlay-kit paired with MUI (in the introduction and more/basic pages), but users adopting other popular design systems have to reverse-engineer how each library's open/onClose and exit-animation callbacks map to overlay-kit's isOpen, close, and unmount. This PR lowers that friction by providing runnable reference examples for the most commonly requested libraries, keeping the docs style and Sandpack structure already established by more/basic.

How Has This Been Tested?

  • Ran `yarn dev` in `docs/` and verified all three new pages compile and render (HTTP 200) at:
    • `/ko/docs/more/with-design-systems/mui`
    • `/ko/docs/more/with-design-systems/chakra-ui`
    • `/ko/docs/more/with-design-systems/ant-design`
  • Verified the English counterparts compile the same way.
  • Verified the sidebar navigation shows the new section and entries in the expected order for both locales.

Screenshots (if appropriate)

N/A

Types of changes

  • Bug fix (non-breaking change which fixes an issue)
  • New feature (non-breaking change which adds functionality)
  • Breaking change (fix or feature that would cause existing functionality to change)
  • Documentation update

Checklist

  • I have performed a self-review of my own code.
  • My code is commented, particularly in hard-to-understand areas.
  • I have made corresponding changes to the documentation.
  • My changes generate no new warnings.
  • I have added tests that prove my fix is effective or that my feature works.
  • New and existing unit tests pass locally with my changes.
  • Any dependent changes have been merged and published in downstream modules.

Further Comments

Commits are split per library so each integration guide can be reviewed (or reverted) independently.

Introduce a new "디자인 시스템과 함께 쓰기 / With Design Systems" section
under docs/more with an example page showing how to use overlay-kit with
MUI's Dialog component. The page covers three patterns:

- overlay.open with Dialog open/onClose
- overlay.openAsync returning user choice as a Promise
- Memory release after exit animation via TransitionProps.onExited

Both Korean and English versions are added.
Add a Chakra UI v3 example under the "디자인 시스템과 함께 쓰기 /
With Design Systems" section. The page demonstrates overlay-kit with
Chakra v3's Dialog.Root, using onOpenChange to bridge the library's
controlled API with overlay-kit's close. Since Chakra v3 does not
expose an exit-animation callback, memory release uses a setTimeout
sized to match the scale motion preset.

Both Korean and English versions are added.
Add an Ant Design example under the "디자인 시스템과 함께 쓰기 /
With Design Systems" section. The page shows overlay-kit paired with
antd's Modal, wiring both onCancel and onOk to close and using the
afterClose prop to call unmount once the exit animation completes.

Both Korean and English versions are added.
@qkraudghgh qkraudghgh requested a review from jungpaeng as a code owner April 23, 2026 06:54
@changeset-bot
Copy link
Copy Markdown

changeset-bot Bot commented Apr 23, 2026

⚠️ No Changeset found

Latest commit: f1cd9b6

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

@vercel
Copy link
Copy Markdown

vercel Bot commented Apr 23, 2026

@qkraudghgh is attempting to deploy a commit to the Toss Team on Vercel.

A member of the Team first needs to authorize it.

@codecov-commenter
Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 99.85%. Comparing base (219c19a) to head (f1cd9b6).

Additional details and impacted files

Impacted file tree graph

@@           Coverage Diff           @@
##             main     #223   +/-   ##
=======================================
  Coverage   99.85%   99.85%           
=======================================
  Files          15       15           
  Lines        1340     1340           
  Branches      262      262           
=======================================
  Hits         1338     1338           
  Misses          2        2           
Components Coverage Δ
overlay-kit 99.85% <ø> (ø)
🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
  • 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

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

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants