Skip to content

docs - #3

Merged
m7md1alaa merged 14 commits into
mainfrom
dev
Aug 20, 2026
Merged

m7md1alaa merged 14 commits into
mainfrom
dev

Conversation

@m7md1alaa

Copy link
Copy Markdown
Owner
  • feat(docs-og): add open graph image template
  • feat(assets): implement image and emoji resolution
  • feat(orchestrate): add image resolution and handling
  • feat(config): add image policy configuration
  • feat(web-ui): implement state persistence and sharing
  • feat(commands): add keyboard shortcut system
  • refactor(studio): extract app state and UI into hooks and components
  • refactor(studio): extract prop and render logic
  • feat(ui): introduce comprehensive component library
  • feat(web-docs): add agent-focused features and improve OG images

Introduces `DocsOgTemplate` for dynamic OG images on docs pages.
Adds studio template for previewing.
Includes ADR 0018 for image/emoji resolution.
Introduce a new module for resolving remote images and emoji glyphs.
Centralize image fetching, policy enforcement, and a shared LRU cache.
Update `takumi-rs` dependencies and shim types to reflect v2 API changes.
Images are now resolved based on a policy (defaulting to deny-all) and passed to the renderer. This enables handling of external images and emoji.
Introduces an `images` property to the studio configuration, allowing users to
customize image fetching behavior, including URL filtering (`allowUrl`),
custom fetch functions, max bytes, timeout, and emoji style.

The configuration schema now correctly preserves function-valued properties
for `allowUrl` and `fetch`. This policy is passed to the rendering process
in both batch and dev server modes.

Ref: ADR-0018
Adds automatic saving of studio state to local storage.
Introduces URL-based sharing of current template, locale, preset, and prop values.
Merges shared state with existing persisted state upon loading.
Introduces a command palette (Mod+K) for quick actions and template switching.
Adds a shortcuts dialog (Mod+/) for viewing and customizing keybindings, which are persisted locally.
Contextual hints are displayed when the Mod key is held.
Moves core studio state management into `useStudioState` and export/share
logic into `useExport`. Splits the main UI into `StudioSidebar` and
`StudioCanvasPanel` components for improved modularity.
Move canvas rendering logic to `useRenderPreview` hook.
Extract prop field classification to `resolve-field-kind.ts`.
Consolidate template prop schema utilities in `template-props.ts`.
Centralize render options building in `renderer.ts`.
Narrow `StudioState` types in components.
Introduce a new set of foundational UI components built on `@base-ui/react` and `@radix-ui`.
This includes a new `ColorPicker` and core primitives like `Button`, `Input`, `Select`, `Tabs`, `Slider`, `Switch`, `Badge`, `Command`, `Toast`, and `Tooltip`.
New theming contexts for `Shape`, `Size`, `Surface`, and `Icon` management are also added.
This refactors many existing custom UI elements to leverage the new library, improving consistency and maintainability.
Introduce an interactive install command toggle, providing distinct commands for "humans" and "agents".
Update agent documentation to detail new plain-text access methods (`/llms.txt`, `.md` suffix) for AI agents.
Implement dedicated Open Graph image generation for the home page and refine the docs OG template.
Enhance home page and root layout metadata for improved SEO and social sharing.
Add `images.allowUrl` configuration to examples for better image source control.
Include minor styling adjustments and a layout fix for the studio sidebar.
@vercel

vercel Bot commented Aug 20, 2026 •

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

1 Skipped Deployment
Project Deployment Actions Updated (UTC)
stdout-design-web-docs Skipped Skipped Aug 20, 2026 2:26pm

…ions

Moves internal files from '@/' to 'src/' for consistency. Converts many function components to const arrow functions and updates imports to use @base-ui/react directly.
Integrates the `ColorPickerPopover` component, replacing the previous custom
HSL slider and EyeDropper implementation. This centralizes color picking
logic and improves the hex input field's user experience by using a draft
state, committing on blur/Enter, and reverting on Escape for partial inputs.
Refactor `HueSlider` and `AlphaSlider` to use a new `ColorPickerSlider` component. This enables custom gradient tracks and thumb colors, which was not possible with the generic `ui/slider`.

Improve color parsing robustness and input component logic by consistently checking for `undefined` instead of `null`. Update `ChannelTooltip` to use explicit `TooltipTrigger` and `TooltipPopup`, and add generic typing to `useProximityHover`.
@m7md1alaa
m7md1alaa merged commit 3861a31 into main Aug 20, 2026
2 of 3 checks passed

This branch was previously deployed

1 inactive deployment
Preview — 6dbe58e2 Deployed Aug 20, 2026 by vercel[bot]
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.

1 participant