Customizing

For bigger changes (styling, new components, custom embeds), vendor tiny-docs into your repo as docs-builder/:

git clone --depth 1 --branch v1 https://github.com/flo-bit/tiny-docs docs-builder
rm -rf docs-builder/.git

The workflow auto-detects docs-builder/ and uses it instead of the upstream copy. Edit anything under docs-builder/src/ and commit — your fork ships on the next push.

Adding a custom component to markdown

1. Create a component, e.g. docs-builder/src/embeds/my-thing/MyThing.astro.

2. Register it in docs-builder/astro.config.ts:

   customEmbeds({
     embeds: [
       // ...existing
       {
         componentName: "MyThing",
         directiveName: "mything",
         importPath: "src/embeds/my-thing",
       },
     ],
   }),

3. Use it in any markdown file:

   ::mything{label="hello" count=3}

Props on the directive are passed straight to the component. For URL-triggered embeds, add a urlMatcher — see src/embeds/youtube/embed.ts for an example.

Local development

npm install
npm run dev

Put markdown in docs/ and a README.md at the repo root, same as the deployed setup.