route-migration

Migrate Vue2 pages.json routing to Vue3 filesystem-based routing with type-safe navigation.

Updated Sep 11, 2025
One-click install
npx skills add https://github.com/ruan-cat/11comm-app --skill route-migration
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: route-migration
Source: https://github.com/ruan-cat/11comm-app/tree/main/.claude/skills/route-migration
Command: npx skills add https://github.com/ruan-cat/11comm-app --skill route-migration

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This migration workflow converts Vue2 pages.json routing to Vue3's filesystem-based routing with strong typing and automation to reduce manual errors.

Core Features & Use Cases

  • End-to-end route migration using a central mapping table (route-migration-map.yml)
  • Type-safe navigation and definePage integration via a TypedRouter-like helper
  • Automatic route generation and validation for multi-page uni-app projects

Quick Start

Read the route-migration-map.yml and begin an end-to-end migration by applying the mapped routes and integrating TypedRouter across the project.

Frequently Asked Questions about route-migration

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I migrate Vue2 routes to Vue3 filesystem-based routing?

Vue2 route migration to Vue3 filesystem-based routing uses a central mapping table to convert pages.json configurations into automated route definitions. It replaces manual route declarations by enforcing PageRoute types and integrating TypedRouter across multi-page uni-app projects.

What is a route migration mapping table and how does it work?

A route migration mapping table, defined in route-migration-map.yml, establishes the source-to-target relationship between Vue2 pages.json entries and Vue3 filesystem-based routes. It serves as the single source of truth to drive automated route generation and type-safe navigation integration.

How do I ensure compile-time safety for typed routing in uni-app projects?

Compile-time safety for typed routing in uni-app projects is ensured by defining PageRoute and PageParams types alongside a TypedRouter helper. This setup validates isValidRoute logic and wires up a cohesive router helper set for type-safe navigation.

Does this Vue2 route migration workflow support multi-page uni-app projects?

Yes, this Vue2 route migration workflow supports multi-page uni-app projects by providing automatic route generation and validation. It integrates TypedRouter across the project to ensure type-safe navigation and full end-to-end migration coverage.

What is the best way to convert pages.json routing configurations to definePage usage?

The best way to convert pages.json routing configurations to definePage usage is by applying a central mapping table that enforces the route-migration map. This approach integrates TypedRouter to ensure compile-time safety and automatic route generation across the project.