@brucesantos/starlight-preset

Preset Starlight compartilhado dos sites de KB da Vectorspace. Substitui os astro.config.mjs quase idênticos dos 7 sites (clients/*/*/website) por uma única função configurável.

Uso

// astro.config.mjs
import { defineConfig } from 'astro/config';
import { vectorspaceStarlight } from '@brucesantos/starlight-preset';

export default defineConfig({
  integrations: [
    vectorspaceStarlight({
      title: 'Bloomy ABA',
      description: 'Conheça a Bloomy — Rede de Clínicas de Terapia ABA',
      widget: 'bloomy/publico',
      obsidian: true,
    }),
  ],
});

O que o preset fixa (convenções do workspace, ver CLAUDE.md raiz):

• locale único pt-BR (root), social: []
• sidebar autogerada — nunca declarar sidebar:
• tableOfContents: { minHeadingLevel: 2, maxHeadingLevel: 4 }
• customCss: ['./src/styles/custom.css']
• favicon: '/favicon.png'
• script do widget ${API_BASE}/widget/{cliente}/{projeto}.js, com VECTORSPACE_API_URL respeitado em dev e fallback https://widget.vectorspace.digital em produção

Opções: obsidian (tema starlight-theme-obsidian, graph/backlinks off), videoThumbs + base (injeta {base}/video-thumbs.js), favicon, customCss, head (entradas extras) e starlight (override total, último a ser aplicado).

O que fica fora do preset, no astro.config.mjs de cada site:

• base do Astro (ex.: enare-instituicoes usa /conhecimento/instituicoes)
• site (ex.: detransp/normas)
• markdown.remarkPlugins (ex.: wikilinks do bloomy/colaboradores, que têm hrefTemplate específico do conteúdo do site)

Migração planejada (matriz real dos 7 sites)

| Site | opções do preset | específico que permanece no site | |---|---|---| | bloomy/colaboradores | obsidian, videoThumbs | markdown.remarkPlugins (wikilinks) | | bloomy/publico | obsidian | — | | detransp/normas | (sem widget — site sem chatbot) | site: 'https://detransp-normas.vercel.app' | | fgv/enare-instituicoes | obsidian, videoThumbs, base | base: '/conhecimento/instituicoes' | | fgv/enare-publico | obsidian | — | | vectorspace/internal | — | — | | vectorspace/public | starlight: { locales: en } (site em inglês) | — |

Distribuição

Publicado como pacote público no npm sob o escopo de usuário @brucesantos (decisão de 2026-07-03 — org @vectorspace não foi criada; escopo de usuário dispensa org). Publicar nova versão:

npm version patch && npm publish --access public && git push --follow-tags