Support Matrix as social button

[orhun]

What version of starlight are you using?

0.13.0

What is your idea?

{
  integrations: [
      social: {
        matrix: "https://matrix.to/#/#ratatui:matrix.org",
      },
  ],
}

Why is this feature necessary?

I'd like to add a Matrix button to my website, next to the other ones on the top:

But I'm getting this when I add a Matrix entry:

10:48:09 AM [vite] Error when evaluating SSR module /home/orhun/gh/ratatui-website/astro.config.mjs:
|- Error: Invalid config passed to starlight integration
**social.matrix**: Invalid enum value. Expected 'twitter' | 'mastodon' | 'github' | 'gitlab' | 'bitbucket' | 'discord' | 'gitter' | 'codeberg' | 'codePen' | 'youtube' | 'threads' | 'linkedin' | 'twitch' | 'microsoftTeams' | 'instagram' | 'stackOverflow' | 'x.com' | 'telegram' | 'rss' | 'facebook' | 'email' | 'reddit' | 'patreon' | 'slack', received 'matrix'
    at Module.StarlightIntegration [as default] (/home/orhun/gh/ratatui-website/node_modules/@astrojs/starlight/index.ts:19:9)
    at /home/orhun/gh/ratatui-website/astro.config.mjs:36:14
    at async instantiateModule (file:///home/orhun/gh/ratatui-website/node_modules/vite/dist/node/chunks/dep-bb8a8339.js:56052:9)

The website code is available here: https://github.com/ratatui-org/website/

Do you have examples of this feature in other projects?

None.

Participation

• I am willing to submit a pull request for this feature.

[orhun]

I would like to contribute this but I don't know where can I find a similar SVG icon to put it in Icons.ts

[delucis]

Would love a PR — thanks for volunteering. This should work for the Icons.ts file:

<path d="M22.5 1.5v21h-2.25V24H24V0h-3.75v1.5h2.25ZM7.46 7.95V9.1h.04a3.02 3.02 0 0 1 2.61-1.39c.54 0 1.03.1 1.48.32.44.2.78.58 1.01 1.1.26-.37.6-.7 1.03-.99.44-.28.95-.43 1.55-.43.45 0 .87.06 1.26.17.38.11.71.29.99.53.27.24.49.56.64.95.15.4.23.86.23 1.42v5.72h-2.34v-4.85c0-.29-.01-.56-.04-.8a1.73 1.73 0 0 0-.18-.67 1.1 1.1 0 0 0-.44-.45 1.6 1.6 0 0 0-.78-.16c-.33 0-.6.06-.8.19-.2.12-.37.29-.48.5a2 2 0 0 0-.23.69c-.04.26-.06.52-.06.78v4.77H10.6v-4.8l-.01-.75a2.29 2.29 0 0 0-.14-.69c-.08-.2-.23-.38-.42-.5a1.5 1.5 0 0 0-.85-.2c-.15.01-.3.04-.44.08-.19.06-.37.15-.52.28-.18.14-.32.34-.44.6-.12.26-.18.6-.18 1.02v4.96H5.25V7.94h2.21ZM1.5 1.5v21h2.25V24H0V0h3.75v1.5H1.5Z"/>

This recent PR adding the Slack icon could be a good reference to see the changes needed: #1075

[orhun]

Submitted a PR here: #1203

[delucis]

Closing as this was released in Starlight v0.15.0!