@plutocms/core 0.38.0 → 0.38.2

package/CHANGELOG.md

@@ -1,6 +1,21 @@
 # Changelog
 
 
+## [0.38.2](https://github.com/plutocms/pluto/compare/v0.38.1...v0.38.2) (2026-10-30)
+
+
+### Bug Fixes
+
+* core no longer bundles the whole simple-icons collection in the server ([#287](https://github.com/plutocms/pluto/issues/287)) ([2322b43](https://github.com/plutocms/pluto/commit/2322b43e4371c34548fdf88124138439c4c7df00))
+* the docs links point to the new /docs URLs ([#289](https://github.com/plutocms/pluto/issues/289)) ([0982146](https://github.com/plutocms/pluto/commit/0982146d82d599c4e7e0f9d2beeec56cd7527be7))
+
+## [0.38.1](https://github.com/plutocms/pluto/compare/v0.38.0...v0.38.1) (2026-10-30)
+
+
+### Bug Fixes
+
+* the core package leaves out its dev scripts ([#284](https://github.com/plutocms/pluto/issues/284)) ([c62763f](https://github.com/plutocms/pluto/commit/c62763f42cd0976514b2de515ea3e52971eef65a))
+
 ## [0.38.0](https://github.com/plutocms/pluto/compare/v0.37.0...v0.38.0) (2026-10-30)
 
 

package/README.md

@@ -34,7 +34,7 @@ export default defineNuxtConfig({
 
 Core is the base layer every Pluto app extends. With no other layer, Pluto is a Markdown CMS on
 Git: posts are files in your repository, and each save is a commit. It works out of the box with your local Git repo in development. Connect GitHub
-to publish from a deployed site. See [GitHub CMS](https://pluto.vulmix.dev/github-cms/quickstart).
+to publish from a deployed site. See [GitHub CMS](https://pluto.vulmix.dev/docs/github-cms/quickstart).
 
 ## Use it headless
 
@@ -44,7 +44,7 @@ A site in any framework reads the published content from the public API:
 curl https://your-site.dev/api/pluto/v1/content/post?limit=10
 ```
 
-See [Public API](https://pluto.vulmix.dev/core/public-api).
+See [Public API](https://pluto.vulmix.dev/docs/core/public-api).
 
 ## Layers
 
@@ -57,13 +57,13 @@ See [Public API](https://pluto.vulmix.dev/core/public-api).
 | `@plutocms/supabase-shop` | Products on Supabase.                                       |
 | `@plutocms/3d`            | 3D models in the media library, and a viewer.               |
 
-Read [Layers](https://pluto.vulmix.dev/core/layers) to see how they fit together.
+Read [Layers](https://pluto.vulmix.dev/docs/core/layers) to see how they fit together.
 
 ## Links
 
-- [Create a project](https://pluto.vulmix.dev/getting-started/create-a-project)
-- [Why Pluto](https://pluto.vulmix.dev/getting-started/why-pluto)
-- [Contributing](https://pluto.vulmix.dev/contributing/workspace)
+- [Create a project](https://pluto.vulmix.dev/docs/getting-started/create-a-project)
+- [Why Pluto](https://pluto.vulmix.dev/docs/getting-started/why-pluto)
+- [Contributing](https://pluto.vulmix.dev/docs/contributing/workspace)
 
 ## License
 

package/app/assets/css/admin-theme.css

@@ -32,7 +32,7 @@
  * Chart colors are a validated categorical palette: lightness band, chroma
  * floor, colorblind separation, and 3:1 contrast pass on white (light) and
  * on the dark card surface (dark). This file is generated; keep the values in
- * sync with scripts/generate-admin-theme.cjs: run it from the repo root, never
+ * sync with scripts/generate-admin-theme.cjs: run it from packages/core, never
  * edit this file by hand.
  */
 :root[data-pluto-admin],

package/app/components/Pluto/Admin/PlutoAdminUserMenu.vue

@@ -48,7 +48,7 @@ const linkItems = computed<DropdownMenuItem[]>(() => [
     ? [
         {
           label: t('pluto.navbar.github'),
-          icon: 'i-simple-icons-github',
+          icon: 'i-pluto-github',
           type: 'link' as const,
           to: 'https://github.com/plutocms/pluto',
           target: '_blank',

package/app/components/Pluto/Github/PlutoGithubSetupPanel.vue

@@ -22,7 +22,7 @@ const props = withDefaults(
   }
 )
 
-const DOCS_URL = 'https://pluto.vulmix.dev/github-cms/quickstart'
+const DOCS_URL = 'https://pluto.vulmix.dev/docs/github-cms/quickstart'
 
 const { t } = usePlutoI18n()
 const setup = usePlutoGithubSetup()
@@ -166,7 +166,7 @@ async function copyCallback() {
         :label="t('pluto.github.setup.create')"
         :color="current.ready ? 'neutral' : 'primary'"
         :variant="current.ready ? 'outline' : 'solid'"
-        icon="simple-icons:github"
+        icon="pluto:github"
         class="w-full justify-center"
         external
       />

package/app/components/Pluto/Github/PlutoGithubSignIn.vue

@@ -89,7 +89,7 @@ const installUrl = computed(() =>
       :to="notReady ? undefined : loginUrl"
       :disabled="notReady"
       :label="t('pluto.github.login.signIn')"
-      icon="simple-icons:github"
+      icon="pluto:github"
       class="w-full justify-center"
       external
     />

package/modules/pluto-github/runtime/app/plugins/pluto-github.ts

@@ -112,7 +112,7 @@ export default defineNuxtPlugin(() => {
         id: 'github',
         order: 150,
         label: 'pluto.settings.tabs.github',
-        icon: 'simple-icons:github',
+        icon: 'pluto:github',
         to: '/admin/settings/github',
       },
     ],

package/nuxt.config.ts

@@ -122,4 +122,23 @@ export default defineNuxtConfig({
       weights: [400, 600, 700],
     },
   },
+
+  // Core ships its one brand icon (GitHub) as a tiny custom collection, so it
+  // does not depend on the whole simple-icons collection (about 4 MB in the
+  // server bundle). Lucide stays a normal installed collection. See the
+  // admin-theme skill.
+  icon: {
+    customCollections: [
+      {
+        prefix: 'pluto',
+        width: 24,
+        height: 24,
+        icons: {
+          github: {
+            body: '<path fill="currentColor" d="M12 .297c-6.63 0-12 5.373-12 12c0 5.303 3.438 9.8 8.205 11.385c.6.113.82-.258.82-.577c0-.285-.01-1.04-.015-2.04c-3.338.724-4.042-1.61-4.042-1.61C4.422 18.07 3.633 17.7 3.633 17.7c-1.087-.744.084-.729.084-.729c1.205.084 1.838 1.236 1.838 1.236c1.07 1.835 2.809 1.305 3.495.998c.108-.776.417-1.305.76-1.605c-2.665-.3-5.466-1.332-5.466-5.93c0-1.31.465-2.38 1.235-3.22c-.135-.303-.54-1.523.105-3.176c0 0 1.005-.322 3.3 1.23c.96-.267 1.98-.399 3-.405c1.02.006 2.04.138 3 .405c2.28-1.552 3.285-1.23 3.285-1.23c.645 1.653.24 2.873.12 3.176c.765.84 1.23 1.91 1.23 3.22c0 4.61-2.805 5.625-5.475 5.92c.42.36.81 1.096.81 2.22c0 1.606-.015 2.896-.015 3.286c0 .315.21.69.825.57C20.565 22.092 24 17.592 24 12.297c0-6.627-5.373-12-12-12"/>',
+          },
+        },
+      },
+    ],
+  },
 })

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@plutocms/core",
   "type": "module",
-  "version": "0.38.0",
+  "version": "0.38.2",
   "description": "The base layer every Pluto app extends: the admin, the content model, and the GitHub CMS",
   "author": "Victor Ribeiro",
   "license": "MIT",
@@ -47,7 +47,6 @@
     "@codemirror/state": "^6.7.6",
     "@codemirror/view": "^6.43.15",
     "@iconify-json/lucide": "^1.2.144",
-    "@iconify-json/simple-icons": "^1.2.100",
     "@internationalized/date": "^3.12.4",
     "@lezer/highlight": "^1.2.5",
     "@nuxt/eslint": "^1.17.0",

package/scripts/generate-admin-theme.cjs

@@ -1,263 +0,0 @@
-// Generates app/assets/css/admin-theme.css from the Pluto UI tokens
-// (app/assets/css/pluto-tokens.css) and the installed Tailwind palette (the
-// status colors). Run from the repo root: node scripts/generate-admin-theme.cjs
-// See the admin-theme skill for the palette choices and how they were
-// validated.
-const fs = require('node:fs')
-const path = require('node:path')
-
-const theme = fs.readFileSync(
-  path.join(
-    path.dirname(
-      require.resolve('tailwindcss/package.json', { paths: [process.cwd()] })
-    ),
-    'theme.css'
-  ),
-  'utf8'
-)
-const tokens = fs.readFileSync('app/assets/css/pluto-tokens.css', 'utf8')
-
-// sRGB hex to an OKLCH literal, so every value in the theme has one form.
-const toLinear = (c) =>
-  c <= 0.04045 ? c / 12.92 : ((c + 0.055) / 1.055) ** 2.4
-function hexToOklch(hex) {
-  const n = Number.parseInt(hex.slice(1), 16)
-  const [r, g, b] = [(n >> 16) & 255, (n >> 8) & 255, n & 255].map((value) =>
-    toLinear(value / 255)
-  )
-  const l = Math.cbrt(0.4122214708 * r + 0.5363325363 * g + 0.0514459929 * b)
-  const m = Math.cbrt(0.2119034982 * r + 0.6806995451 * g + 0.1073969566 * b)
-  const s = Math.cbrt(0.0883024619 * r + 0.2817188376 * g + 0.6299787005 * b)
-  const L = 0.2104542553 * l + 0.793617785 * m - 0.0040720468 * s
-  const A = 1.9779984951 * l - 2.428592205 * m + 0.4505937099 * s
-  const B = 0.0259040371 * l + 0.7827717662 * m - 0.808675766 * s
-  const C = Math.hypot(A, B)
-  const H = ((Math.atan2(B, A) * 180) / Math.PI + 360) % 360
-  return `oklch(${(L * 100).toFixed(1)}% ${C.toFixed(3)} ${H.toFixed(2)})`
-}
-
-// A Pluto token (tholin, haze, heart, kuiper) or a Tailwind color, as an OKLCH literal.
-function v(name) {
-  const own = tokens.match(
-    new RegExp(String.raw`--color-${name}: (#[0-9A-Fa-f]{6})`)
-  )
-  if (own) {
-    return hexToOklch(own[1])
-  }
-  return theme.match(
-    new RegExp(String.raw`--color-${name}: (oklch\([^)]*\))`)
-  )[1]
-}
-
-// Tholin is a red-orange (hue 37). Tailwind red (hue 27) looks like it next
-// to a primary button, so errors use rose (hue 17). Info is haze, the blue of
-// the Pluto palette.
-const roles = {
-  primary: 'tholin',
-  secondary: 'haze',
-  success: 'green',
-  info: 'haze',
-  warning: 'amber',
-  error: 'rose',
-  neutral: 'kuiper',
-}
-const shades = [50, 100, 200, 300, 400, 500, 600, 700, 800, 900, 950]
-const scales = Object.entries(roles)
-  .map(
-    ([role, hue]) =>
-      `  /* ${role}: ${hue} */\n${shades.map((s) => `  --ui-color-${role}-${s}: ${v(`${hue}-${s}`)};`).join('\n')}`
-  )
-  .join('\n\n')
-
-// The semantic step of each role. Light: tholin 600 and haze 700 for 4.5:1 on
-// white (the docs site uses the same steps), the status colors at 500. Dark:
-// 400 for every role.
-const lightSteps = {
-  primary: 600,
-  secondary: 700,
-  success: 500,
-  info: 500,
-  warning: 500,
-  error: 500,
-}
-const semantic = (steps) =>
-  Object.entries(steps)
-    .map(([role, step]) => `  --ui-${role}: var(--ui-color-${role}-${step});`)
-    .join('\n')
-const darkSteps = Object.fromEntries(
-  Object.keys(lightSteps).map((role) => [role, 400])
-)
-
-const n = (s) => `var(--ui-color-neutral-${s})`
-const neutralLight = {
-  'text-dimmed': n(400),
-  'text-muted': n(500),
-  'text-toned': n(600),
-  text: n(700),
-  'text-highlighted': n(900),
-  'text-inverted': '#fff',
-  bg: '#fff',
-  'bg-muted': n(50),
-  'bg-elevated': n(100),
-  'bg-accented': n(200),
-  'bg-inverted': n(900),
-  border: n(200),
-  'border-muted': n(200),
-  'border-accented': n(300),
-  'border-inverted': n(900),
-}
-// Dark surfaces on the kuiper hue (273). Cards sit one step above the
-// kuiper-900 canvas. The sidebar sits between the kuiper-950 navbar and the
-// canvas. The chart palette passes the dataviz checks on the card surface.
-const CARD_DARK = 'oklch(28% 0.042 273)'
-const SIDEBAR_DARK = 'oklch(20.5% 0.040 273)'
-const neutralDark = {
-  'text-dimmed': n(500),
-  'text-muted': n(400),
-  'text-toned': n(300),
-  text: n(200),
-  'text-highlighted': '#fff',
-  'text-inverted': n(900),
-  bg: CARD_DARK,
-  'bg-muted': n(800),
-  'bg-elevated': n(800),
-  'bg-accented': n(700),
-  'bg-inverted': '#fff',
-  border: n(800),
-  'border-muted': n(700),
-  'border-accented': n(700),
-  'border-inverted': '#fff',
-}
-const declare = (o) =>
-  Object.entries(o)
-    .map(([k, val]) => `  --ui-${k}: ${val};`)
-    .join('\n')
-
-// The chart series, in a fixed order: tholin, haze, lime, violet, teal, amber.
-// Validated with the dataviz palette checks (lightness band, chroma floor,
-// colorblind and normal-vision separation of neighbors, 3:1 contrast) on white
-// for light, and on the dark card surface for dark. Dark uses tholin 500, not
-// the primary 400, which is too light for the dark band. Re-run the checks
-// before you change a slot.
-const chartLight = [
-  'tholin-600',
-  'haze-600',
-  'lime-700',
-  'violet-500',
-  'teal-600',
-  'amber-600',
-]
-const chartDark = [
-  'tholin-500',
-  'haze-500',
-  'lime-600',
-  'violet-500',
-  'teal-600',
-  'amber-600',
-]
-// Slot 1 reads the primary scale (tholin 600 in light, 500 in dark), so a
-// brand primary (appConfig.pluto.brand) recolors it too.
-function chart(list, primaryStep) {
-  return [
-    `  --ui-chart-1: var(--ui-color-primary-${primaryStep}); /* ${list[0]} */`,
-    ...list
-      .slice(1)
-      .map((c, i) => `  --ui-chart-${i + 2}: ${v(c)}; /* ${c} */`),
-  ].join('\n')
-}
-
-const css = `/*
- * The Pluto admin theme.
- *
- * Two selectors carry it:
- * - \`:root[data-pluto-admin]\`: usePlutoAdminTheme() sets this attribute on
- *   <html> while an admin layout is mounted, so the theme also covers
- *   overlays (modals, slideovers, menus, toasts, the command palette) that
- *   render at the end of <body>.
- * - \`[data-pluto-admin-scope]\`: for admin chrome that also shows on the
- *   public site, such as the admin navbar for a logged-in admin.
- *
- * \`[data-pluto-admin-dark]\` takes the dark tokens in both color modes. The
- * admin navbar is near black in light mode too, so its text and buttons need
- * the dark values.
- *
- * The colors are the Pluto UI tokens (pluto-tokens.css): primary tholin,
- * secondary and info haze, neutral kuiper. The status colors come from
- * Tailwind: green, amber, rose. The fonts are Public Sans for text and
- * Fredoka for page titles.
- *
- * Every value is a literal. The consumer app styles its public site through
- * its own app.config colors and @theme. Both reach the admin unless the admin
- * pins its own values: app.config colors set Nuxt UI's --ui-color-* scales on
- * :root, and @theme can redefine a Tailwind color such as --color-red-400.
- * These selectors are more specific than Nuxt UI's :root and .dark rules.
- *
- * The semantic tokens (--ui-primary, --ui-bg, --ui-text, ...) are declared
- * again here, not only the color scales. A custom property inherits as a
- * resolved value, so on a scoped element the :root tokens would still hold
- * the app's colors.
- *
- * Chart colors are a validated categorical palette: lightness band, chroma
- * floor, colorblind separation, and 3:1 contrast pass on white (light) and
- * on the dark card surface (dark). This file is generated; keep the values in
- * sync with scripts/generate-admin-theme.cjs: run it from the repo root, never
- * edit this file by hand.
- */
-:root[data-pluto-admin],
-[data-pluto-admin-scope] {
-${scales}
-
-${semantic(lightSteps)}
-
-${declare(neutralLight)}
-
-${chart(chartLight, 600)}
-
-  /* Surfaces. The navbar is near black in both modes. */
-  --pluto-admin-canvas: #fff;
-  --pluto-admin-sidebar: ${v('kuiper-50')};
-  --pluto-admin-navbar: ${v('kuiper-950')};
-
-  /* The Pluto fonts, as literals like the colors (see pluto-tokens.css). */
-  --font-sans: "Public Sans", ui-sans-serif, system-ui, sans-serif;
-  --pluto-admin-font-display: "Fredoka", "Public Sans", ui-sans-serif, system-ui, sans-serif;
-}
-
-:root[data-pluto-admin].dark,
-.dark [data-pluto-admin-scope],
-[data-pluto-admin-dark] {
-${semantic(darkSteps)}
-
-${declare(neutralDark)}
-
-${chart(chartDark, 500)}
-
-  /*
-   * Four steps, darkest at the top: a near-black navbar, a darker sidebar,
-   * a dim dark canvas (not pitch black), and cards (--ui-bg) one step above
-   * the canvas.
-   */
-  --pluto-admin-navbar: ${v('kuiper-950')};
-  --pluto-admin-sidebar: ${SIDEBAR_DARK};
-  --pluto-admin-canvas: ${v('kuiper-900')};
-}
-
-:root[data-pluto-admin] body {
-  background-color: var(--pluto-admin-canvas);
-}
-
-:root[data-pluto-admin] body,
-[data-pluto-admin-scope] {
-  font-family: var(--font-sans);
-  color: var(--ui-text);
-}
-
-/* Page titles (h1 only) use the rounded face of the wordmark, as on the docs site. */
-:root[data-pluto-admin] h1,
-[data-pluto-admin-scope] h1 {
-  font-family: var(--pluto-admin-font-display);
-  letter-spacing: -0.01em;
-}
-`
-fs.writeFileSync('app/assets/css/admin-theme.css', css)
-console.log('written', css.split('\n').length, 'lines')

package/tailwind.lint.css

@@ -1,10 +0,0 @@
-/*
- * The Tailwind design system for ESLint (better-tailwindcss) and the editor
- * (Tailwind IntelliSense). It is not part of the build: a Pluto layer has no
- * Tailwind entry, the app owns it (see the single-tailwind-build skill). This
- * file gives the lint the same theme as an app: Tailwind, Nuxt UI, and the
- * Pluto layer CSS (the Pluto UI tokens and the admin theme).
- */
-@import 'tailwindcss';
-@import '@nuxt/ui';
-@import './app/assets/css/pluto-layer.css';