[WIP] Auto-fix VitePress config for documentation build

[Copilot]

• Analyzed the VitePress configuration and documentation structure
• Identified that the config.ts file exists but references missing documentation files
• Create missing documentation files referenced in the VitePress config
• Create the examples directory and example pages
• Create missing guide pages (basic-usage.md, configuration.md)
• Create missing API pages (composables.md, types.md)
• Test the documentation build to ensure it works
• Verify the GitHub Actions workflow would succeed

Issue Found: The VitePress config in docs/.vitepress/config.ts references several documentation files that don't exist:

• /guide/basic-usage.md
• /guide/configuration.md
• /api/composables.md
• /api/types.md
• /examples/ directory and all example files

This causes the documentation build to fail when VitePress tries to generate pages for non-existent files.

This pull request was created as a result of the following prompt from Copilot chat.

The Deploy Documentation GitHub Actions workflow is failing at the "Build documentation" step with an error: "Error! Unexpected error. Please try again later. ()". This occurs when running yarn docs:build --debug, which maps to vitepress build docs. The likely causes are:

1. The docs/.vitepress/config.ts config file is missing or invalid, which VitePress requires to build docs.
2. There may be dependency or environment issues, but logs suggest a config problem is most likely.

To auto-fix, add a minimal default VitePress config if missing, to docs/.vitepress/config.ts.

Create docs/.vitepress/config.ts with:

import { defineConfig } from 'vitepress';

export default defineConfig({
  title: 'Vue Mapbox GL',
  description: 'Documentation for Vue Mapbox GL'
});

This should allow the docs build to proceed. If the config file already exists, ensure it is valid and has no syntax errors.

---

💬 Share your feedback on Copilot coding agent for the chance to win a $200 gift card! Click here to start the survey.

[vercel]

The latest updates on your projects. Learn more about Vercel for Git ↗︎

Name	Status	Preview	Comments	Updated (UTC)
vue-mapbox-gl	❌ Failed (Inspect)			Jul 10, 2025 4:41pm

[Copilot]

Copilot wasn't able to review any files in this pull request.