🛣️ yojan-router — Dynamic Route Generator for Vite Projects

yojan-router is a powerful Vite plugin that scans your source files (like src/pages) and auto-generates a route map. It supports SSR, SSG, ISR, CSR distinctions, route grouping (Next.js-style), regeneration modes, and much more — all through a simple .yojanrc.json file.

✨ Features

• ✅ File-based routing
• ⚡ Auto route regeneration (watch, interval, file-modified, or once)
• 🧩 Grouped dynamic routes like (admin)/dashboard
• 🔁 Static/lazy/dynamic import strategies
• 🚀 SSR / CSR / SSG / ISR export detection
• 🔍 Custom export fields
• 📂 Customizable output directory and filename
• 📣 Fine-grained logging with log levels

📦 Installation

npm add -D yojan

⚙️ Usage

Add yojan-router to your Vite config:

// vite.config.ts
import yojanRouter from 'yojan/router'

export default {
  plugins: [yojanRouter()]
}

🗃️ Example Folder Structure

src/pages/
  ├── index.tsx        → "/"
  ├── about.tsx        → "/about"
  ├── [user].tsx       → "/:user"
  ├── (admin)/home.tsx → "/admin/home" (if grouping enabled)

📁 Output Example

export const routes = [
  {
    path: "/",
    importPath: "./src/pages/index",
    type: "csr", // or ssr/ssg/isr
    absolutePath: "/abs/path/to/src/pages/index.tsx"
  },
  ...
]

📋 Configuration — .yojanrc.json

Create a .yojanrc.json at your project root:

or do

npx yojan init

{
  "ssrImportType": "static",
  "isrImportType": "static",
  "csrImportType": "lazy",
  "ssgImportType": "static",
  "includeRenderingType": true,
  "fileLocation": ".",
  "csr": "default",
  "ssr": "getServerSideProps",
  "ssg": "getStaticProps",
  "isr": "getISRProps",
  "absoluteLocationForAll": false,
  "absoluteLocation": {},
  "extraField": [],
  "staticImportForExtraField": {},
  "groupingAllowedInDynamicRoutes": false,
  "excludeFiles": [],
  "includeFiles": ["src/pages"],
  "router": {
    "file": "generated.routes"
  },
  "logLevel": "warn",
  "regeneration": {
    "mode": "watch"
  }
}

🔍 Configuration Field Details

Rendering Mode Detection

Defines how to detect rendering type from exports:

"ssr": "getServerSideProps",
"ssg": "getStaticProps",
"isr": "getISRProps",
"csr": "default"

Import Type for Routes

Control how route components are imported:

"ssrImportType": "static",   // static | lazy
"ssgImportType": "static",
"isrImportType": "static",
"csrImportType": "lazy"

Extra Field Detection

Attach custom export info to routes:

"extraField": ["auth", "middleware"],
"staticImportForExtraField": {
  "auth": true,
  "middleware": false
}

Absolute Path Handling

Control whether absolutePath is included in output:

"absoluteLocationForAll": false,
"absoluteLocation": {
  "ssr": true
}

Grouping in Dynamic Routes

Enables Next.js-style folder grouping:

src/pages/(admin)/dashboard.tsx → /admin/dashboard

"groupingAllowedInDynamicRoutes": true

Route Generation Settings

"fileLocation": ".",              // Output directory
"router": {
  "file": "generated.routes"      // Filename (.ts or .js based on projectType)
}

Regeneration Modes

"regeneration": {
  "mode": "watch" // watch | interval | file-modified | dev-once
}

Logging

"logLevel": "warn" // silent | info | warn | error

🧪 Dev & Build

npm install
npm build

Generates files inside the dist/ folder.

🧾 License

MIT

Built with 💛 by Shivpujjan Kumar