Skip to content

Comments

Fix plugin tutorial links: use /plugins/ route instead of non-existent /plugins-tutorials/#493

Draft
Copilot wants to merge 3 commits intomainfrom
copilot/fix-tutorial-link-redirect
Draft

Fix plugin tutorial links: use /plugins/ route instead of non-existent /plugins-tutorials/#493
Copilot wants to merge 3 commits intomainfrom
copilot/fix-tutorial-link-redirect

Conversation

Copy link
Contributor

Copilot AI commented Feb 23, 2026

Tutorial links in plugin documentation were using /plugins-tutorials/ path, which doesn't exist as a route. Users were redirected to the landing page instead of tutorials.

Root Cause

Content collection loads from src/content/plugins-tutorials/ directory but the Astro page route is defined at src/pages/plugins/[slug].astro, making the URL path /plugins/{slug}, not /plugins-tutorials/{slug}.

Changes

  • 72 plugin getting-started.mdx files: Updated tutorial links across 8 plugins (accelerometer, audio-recorder, barometer, contacts, fast-sql, pedometer, realtimekit, share-target) × 9 languages
  • 8 adding-plugins.mdx files: Preserved correct source directory references for contributors

Example Fix

- See the [tutorial](/plugins-tutorials/capacitor-pedometer) for advanced implementation
+ See the [tutorial](/plugins/capacitor-pedometer) for advanced implementation

Technical Detail

The content collection name and source directory don't dictate the URL route - the page file location in src/pages/ does. Collection "plugin" sourced from plugins-tutorials/ is served at /plugins/ per routing convention.

Warning

Firewall rules blocked me from connecting to one or more addresses (expand for details)

I tried to connect to the following addresses, but was blocked by firewall rules:

  • npm.jsr.io
    • Triggering command: /home/REDACTED/.bun/bin/bun bun install tnet/tools/sed sed -i g ev/capacitor-updater.mdx /home/REDACTED/work/_temp/ghcca-node/node/bin/sed g neral.mdx d sed -i g mdx tnet/tools/sed g ndex.mdx /home/REDACTED/worgit status --porcelain --ignore-submodules | head -n 10 sed (dns block)
    • Triggering command: /home/REDACTED/.bun/bin/bun bun install --no-verify sed -i g ev/contributing.mdx de/node/bin/sed g s.mdx nfig/composer/ves|/plugins-tutorials/|/plugins/|g sed -i g (dns block)

If you need me to access, download, or install something from one of these locations, you can either:

Original prompt

This section details on the original issue you should resolve

<issue_title>Bug — “tutorial” link redirects to landing page instead of tutorial</issue_title>
<issue_description>### Description
On the Getting Started page of the pedometer plugin, inside the Next Steps section, the “tutorial” link does not redirect to the expected tutorial page.

When clicking the link, the user is redirected to the website landing page instead of the tutorial.

Steps to reproduce

  1. Go to:
    https://capgo.app/docs/plugins/pedometer/getting-started/#next-steps
  2. Click on the tutorial link

Expected behavior

The link should open the related advanced implementation tutorial page.

Actual behavior

The click redirects to the main landing page</issue_description>

Comments on the Issue (you are @copilot in this section)


💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.

Copilot AI and others added 2 commits February 23, 2026 19:51
Co-authored-by: riderx <4084527+riderx@users.noreply.github.com>
…as plugins-tutorials)

Co-authored-by: riderx <4084527+riderx@users.noreply.github.com>
@sonarqubecloud
Copy link

Copilot AI changed the title [WIP] Fix tutorial link redirecting to landing page Fix plugin tutorial links: use /plugins/ route instead of non-existent /plugins-tutorials/ Feb 23, 2026
Copilot AI requested a review from riderx February 23, 2026 19:55
@riderx
Copy link
Member

riderx commented Feb 23, 2026

@copilot the tutorial should exist, like we make a tutorial for every fucking plugin, so the link should work because the tutorial should work.

Copy link
Contributor Author

Copilot AI commented Feb 23, 2026

@copilot the tutorial should exist, like we make a tutorial for every fucking plugin, so the link should work because the tutorial should work.

You're absolutely right! The tutorials do exist in /src/content/plugins-tutorials/ and the fix ensures the links now point to the correct /plugins/capacitor-pedometer route (instead of the non-existent /plugins-tutorials/capacitor-pedometer route).

The routing works as follows:

  • Tutorial source files: /src/content/plugins-tutorials/en/capacitor-pedometer.md
  • Astro generates route: /plugins/capacitor-pedometer via src/pages/plugins/[slug].astro
  • Fixed link in docs: /plugins/capacitor-pedometer

The fix is complete in commits 28a7a12 and 4bc7f97. The tutorial links now work correctly for all 8 affected plugins across all 9 language translations (80 files total).

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Bug — “tutorial” link redirects to landing page instead of tutorial

2 participants