Skip to content

Conversation

@techniq
Copy link
Owner

@techniq techniq commented Oct 16, 2025

Goals

  • Provide complete / standalone / isolated examples with easy copy and paste and ability to open in Svelte REPL/Playground or Stackblitz
  • New Examples browse page with filtering
  • Automatic find related examples for all components
  • Expose APIs (generated from $prop() types)
  • Improved search (sub-section)
  • Improved design
  • Better separation of library and docs dependencies

Closes #620

PR also

  • Adds settings (default layer type and debug)
  • Layer improvements
    • respects layer setting (default)
    • integrates debug setting (overall and padding bounds)

TODO

Existing

  • Create new docs projects at {project_root}/docs}
  • Setup content-collections
  • Setup mdsx
  • Setup Tailwind / Theme select
  • Setup unplugin-icons
  • Setup Svelte UX
  • Table of Contents
  • Analytics
  • Integrate renderContext (svg/canvas/html) setting
  • Integrate debug setting
  • Setup CI (build)
  • Deploy new site to Cloudflare (new directory)
  • Identify pattern to define examples
    • preprocess markdown code blocks
      • Pro
        • Faster to migrate
        • Quick to iterate
      • Con
        • More difficult to implement (find old preprocessor)
    • Separate page per example (almost 700)
      • Pro
        • Better tooling (prettier, errors)
        • Easier to implement (?raw for source)
        • Full examples (<script>)
        • Easier to open in REPL
      • Con
        • More intensive (almost 700)
        • Each needs distinct name
  • Migrate all examples
  • Search
  • Responsive layout
  • light/dark shiki themes
  • Remove old site (after migrated)
  • Update Getting Started
  • Fix screenshots (show full examples (multi-chart), hide controls)
  • Fix data warning (box value in object)

New


Structure

I'm also thinking we have the following sections (not rigid, but general ideas):

possibly

  • Updates (News / Blog)

Issues

@changeset-bot
Copy link

changeset-bot bot commented Oct 16, 2025

🦋 Changeset detected

Latest commit: 5002cd4

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 8 packages
Name Type
layerchart Minor
shadcn-svelte-1 Patch
svelteux-2 Patch
skeleton-3 Patch
skeleton4 Patch
standalone Patch
daisyui-5 Patch
docs Patch

Not sure what this means? Click here to learn what changesets are.

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

@github-actions
Copy link
Contributor

github-actions bot commented Oct 16, 2025

built with Refined Cloudflare Pages Action

⚡ Cloudflare Pages Deployment

Name Status Preview Last Commit
layerchart ✅ Ready (View Log) Visit Preview 5002cd4

@pkg-pr-new
Copy link

pkg-pr-new bot commented Oct 16, 2025

Open in StackBlitz

npm i https://pkg.pr.new/layerchart@659

commit: 5002cd4

- added code (w/interpretation) to illustrate how each one is implemented.
* more-custom-icons

- Relates to Getting Started Page.
- updated tabs to use custom icons for shadcn-svelte, skeleton, svelteux, daisyui, unocss and vanilla CSS (defined in vite.config.ts.
- added reference to unocss start project (coming separate PR).
- sliglt update of copy text to note unocss.

* Replace custom tailwindcss and unocss icons with vscode iconset

* Install @iconify-json/logos iconset and use for tailwind (more vibrant) and unocss (for consisistency).  Remove `<Icon>` component wrapper and use icon component directly.  Refine some wording

---------

Co-authored-by: Sean Lynch <techniq35@gmail.com>
… the existing `<Example component="Foo" name="bar">`
* refactor: migrate from lodash to layerstack/utils

* build(deps): bump layerstack

* refactor(utils): simplify get call

* chore: add changeset
* unocss

WIP
colors issues

* Switch to wind4 unocss preset and generate theme css variables (`--colors-*`)

* Add <main> padding to match other examples

* Remove unocss reset to fix conflict with tooltip (and other) default styles that use layers (ex. components) and `:where` with 0 specificity

---------

Co-authored-by: Sean Lynch <techniq35@gmail.com>
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.

4 participants