mobileid-docs

⚠️ Work in Progress This repository is currently under active development. Content and structure may change frequently.

This repository contains documentation resources related to MobileID.

For full documentation, visit the official site:

• MobileID Documentation

SEO & Indexing

The site is configured for search-engine and AI-agent discoverability. Everything is generated automatically during npm run docs:build.

What's set up

Artifact	Source	Deployed URL
robots.txt	docs/public/robots.txt (static)	https://docs.mobileid.ch/robots.txt
sitemap.xml	Auto-generated by VitePress (sitemap.hostname in config)	https://docs.mobileid.ch/sitemap.xml
llms.txt	docs/public/llms.txt (static)	https://docs.mobileid.ch/llms.txt
CNAME	docs/public/CNAME (static)	— (consumed by GitHub Pages)

Meta tags (per page, automatic)

Every built page includes:

• <link rel="canonical"> pointing to https://docs.mobileid.ch/…
• <meta name="robots" content="index, follow">
• OpenGraph tags (og:title, og:description, og:url, og:site_name, og:type)
• Twitter summary card

These are injected via transformPageData in docs/.vitepress/config.mts.

How sitemap generation works

VitePress 1.x has built-in sitemap support. The config contains:

sitemap: {
  hostname: 'https://docs.mobileid.ch',
}

On every build, VitePress generates sitemap.xml in the dist root with <lastmod> timestamps derived from git history (because lastUpdated: true).

Maintaining llms.txt

Edit docs/public/llms.txt directly. Keep all URLs as absolute (https://docs.mobileid.ch/…). Update whenever pages are added or removed.

Verification after deploy

curl -s https://docs.mobileid.ch/robots.txt | head
curl -s https://docs.mobileid.ch/sitemap.xml | head
curl -s https://docs.mobileid.ch/llms.txt | head