Skip to content

Use Svelte and Phoundry UI

Svelte 5 and Phoundry UI are the recommended stack for plugin interfaces. The plugin starter repo already includes Svelte, TypeScript, Vite, the public SDK npm package, and phoundry-ui. Phials supplies the shared UI styles and active theme; you can use component CSS without installing Tailwind. Start there so your components use the same compilation and packaging contract that Phials expects.

Phials mounts a plugin component into several kinds of host-owned space:

  • a responsive file viewer or editor
  • a file toolbar contribution
  • a file view
  • a left, right, or bottom panel
  • a center tab
  • a custom plugin-settings interface

The public SDK declares the props for each surface. Your component owns its markup and local state; Phials owns when it is mounted, which props it receives, and where it appears. Build against those props instead of reading application globals or assuming a particular dock, tab, or window size.

  1. Build plugin components with Svelte 5 to learn the component boundary, props, state, and cleanup patterns used by plugin capabilities.
  2. Use Phoundry UI components for controls that should match Phials interaction and accessibility behavior.
  3. Style and theme plugin interfaces using component CSS and the active theme.
  4. Design responsive and accessible plugin surfaces for narrow panels, wide center tabs, keyboard use, focus, and assistive technology.

These articles explain the Phials-specific working contract rather than general Svelte development. The Svelte documentation remains the source for the language and framework as a whole.

Before adding a component

Choose the plugin capability first. Its provider contract determines the component props and lifecycle:

Use one component in more than one placement only when it responds to its container and every placement has the same interaction semantics. A file surface, for example, can appear in different host destinations, while a panel or tab component receives a different public props contract.

This article includes AI-assisted content.

Documentation is licensed under CC BY 4.0. Phoundry names and marks remain reserved.