OSS探訪

pathpida — Next.jsの内部リンクとqueryをTypeScriptで型安全に生成する

スコアの見方

OSS規模スコアはStars・Watchers・Forks・Contributorsを対数圧縮して重み付けした現在の規模指標(上限なし)です。発掘スコアは現在のOSS規模スコアから発掘時点のOSS規模スコアを引いた値、更新ペースは直近30日Commit数、成長モメンタムは直近の観測期間におけるOSS規模スコア差、OSS健全度は取得できた更新状況・Community Health・Releaseの0〜100評価です。

Stars
518
主要言語
TypeScript
ライセンス
MIT
リポジトリ最終更新
2026/09/12

概要

pathpidaは、Next.jsやVinextのpages構成から内部リンク用の型定義を生成する開発ツールです。生成された`pagesPath`を使い、動的routeやqueryをTypeScriptの型で確認しながらURLを組み立てられます。

特徴と向いている用途

公式資料に基づく紹介・実機未検証 · 内容確認日:

pages構成から`$path.ts`を自動生成する

routeファイルを読み取り、静的path・動的parameterを表現するpagesPathを生成します。watch modeを使えば開発中の変更にも追従できます。

出典:[2]

queryとpublic配下の静的ファイルも型で扱う

page側でQuery/OptionalQueryを定義してURL生成時の引数を型検査でき、--enableStaticではpublic配下の静的ファイルpathも生成できます。

出典:[2]

Next.jsで内部リンクの文字列ミスを減らしたい場合に

動的routeやqueryが増え、router.pushLinkへ手書きpathを渡す箇所を型安全にしたいプロジェクトに向きます。

出典:[2]

生成元のrouting構成と導入versionを確認する

READMEはpages/を基準にした例を掲載しています。異なるrouting方式や新しいNext.js構成で使う場合は、採用versionの対応範囲を確認してください。

出典:[2][3]

参考にした公式資料

  1. [1]aspida/pathpida repository(2026-09-21)
  2. [2]pathpida README(2026-09-21)
  3. [3]pathpida package.json(2026-09-21)
  4. [4]pathpida MIT license(2026-09-21)
編集部からの補足

pathpidaは実行時ライブラリではなく、route構成から`$path.ts`を生成するzero-runtimeの開発ツールです。現行mainの`package.json`はversion `0.0.0`を開発用placeholderとしているため、これを公開versionとして扱っていません。READMEの例は`pages/`構成を基準にしているため、異なるrouting構成では互換性を確認してください。

3ステップで試す

  1. 1

    pathpidaを開発依存へ追加

    READMEのnpm手順でpath generatorとscript並列実行用packageを追加します。

    npm install pathpida npm-run-all --save-dev
  2. 2

    生成scriptをpackage.jsonへ追加

    READMEのSetup例に従い、pages変更時に$path.tsを再生成するwatch scriptを追加します。

    "dev:path": "pathpida --ignorePath .gitignore --watch"
  3. 3

    型付きpathを生成して利用

    生成されたpagesPathから$url()を呼び、動的routeやqueryがTypeScriptで検査されることを確認します。

    npm run dev:path → import { pagesPath } from "../lib/$path"
公式READMEで確認

成長

成長の推移 · 直近30日

518 Stars

推移データを蓄積中です。

開発アクティビティ

直近90日・週次

Commit(直近30日)
4
Open PR
5

開発アクティビティを蓄積中です。

Built with

カテゴリとタグ

GitHubデータ

GitHubのデータGitHubの詳細データを見る

GitHub Topics

  • typescript
  • nextjs
Stars
518
Forks
32
Watchers
1
Open Issues
8
Contributors
13
主要言語
TypeScript
ライセンス
MIT
リポジトリ最終更新
2026/09/12

このOSSの使い方や活用事例をMarkdownで投稿できます。管理者が承認した後に公開されます。

情報の誤りを報告

掲載内容に誤りや古い情報があればお知らせください。