skills.rest
matthewharwood
matthewharwoodCOMMUNITY
Explore all skills by this author →
GitHub

tanstack-router-pwa-deep-links

Serve a prerendered SPA shell for offline deep-link navigation with TanStack Router.

1|Updated Apr 26, 2026
Search Tags:#offline#navigation#pwa#tanstack-router#deep-links#workbox
One-click install
npx skills add https://github.com/matthewharwood/dean-stack --skill tanstack-router-pwa-deep-links
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: tanstack-router-pwa-deep-links
Source: https://github.com/matthewharwood/dean-stack/tree/main/.claude/skills/tanstack-router-pwa-deep-links
Command: npx skills add https://github.com/matthewharwood/dean-stack --skill tanstack-router-pwa-deep-links

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Offline navigation for deep links when the network is unavailable: the service worker serves the prerendered SPA shell and the TanStack Router resolves the URL client-side, preventing 404s and broken offline navigation.

Core Features & Use Cases

  • Defines the contract between Workbox navigation handling and TanStack Router to enable offline deep-link resolution via a prerendered SPA shell.
  • Ensures the navigation fallback points to the canonical shell, allowing client-side routing to handle unknown paths without server round-trips.
  • Useful for diagnosing offline deep-link scenarios and validating the end-to-end offline navigation flow in PWAs.

Quick Start

Test by opening a deep link while offline to confirm the prerendered shell loads and the router resolves the route.

Frequently Asked Questions about tanstack-router-pwa-deep-links

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

FAQPage Schema
How do I fix offline navigation failures for deep links in a PWA?▼

Offline navigation failures for deep links are fixed by serving a prerendered SPA shell via a Workbox navigation fallback, allowing TanStack Router to resolve the URL client-side without server round-trips.

Why does my SPA return a 404 when opening a deep link while offline?▼

An SPA returns a 404 on offline deep links when the service worker lacks a navigation fallback to the canonical shell, preventing client-side routing from hydrating and resolving the unknown path.

How do I configure Workbox navigation handling for TanStack Router deep links?▼

Configuring Workbox navigation handling involves setting a fallback to the prerendered SPA shell, ensuring TanStack Router hydrates and resolves the deep link route client-side during network outages.

Does TanStack Router support offline deep-link resolution without server round-trips?▼

Yes, TanStack Router supports offline deep-link resolution by booting a prerendered SPA shell served by Workbox, allowing the browser to handle navigation and route resolution entirely client-side.

What is the required fallback for offline deep links in a TanStack Router PWA?▼

The required fallback for offline deep links is a Workbox-driven navigation fallback pointing to the canonical SPA shell, which ensures the router hydrates and resolves missing prerendered routes.

How do I test offline deep-link navigation in a TanStack Router PWA?▼

Testing offline deep-link navigation involves opening a deep link while the network is unavailable to confirm the prerendered SPA shell loads and TanStack Router resolves the route client-side.

Related Skills

Explore More Software Engineering Skills→
matthewharwoodmatthewharwood
1

playwright-pwa-offline

Validate offline deep-link routing against a prerendered Workbox shell.

Community
Advanced
djcyphersdjcyphers

network-diagnostics

Diagnose network connectivity issues with DNS, routing, port, and firewall checks.

Community
Basic
hashintelhashintel
7

compositions-router-query

Integrate TanStack Router with TanStack Query for synchronized navigation and data caching.

Official
Advanced
matthewharwoodmatthewharwood
1

tanstack

Route TanStack Start questions to the appropriate sub-skill.

Community
Advanced