Series: TanStack Router Lesson 5

TanStack Router o‘rnatish — Vite + React + TypeScript loyihasiga ulash

TanStack Router'ni Vite + React + TypeScript loyihasiga o'rnatish: paketlar, Vite plagini, src/routes/ papkasi, __root.tsx, routeTree.gen.ts va DevTools integratsiyasi.

5-dars

TanStack Router o‘rnatish — Vite + React + TypeScript loyihasiga ulash

Tasavvur qiling, siz yangi zamonaviy poyga avtomobilining barcha qismlarini (Vite + React + TypeScript) garajingizga keltirdingiz. Endi unga eng so‘nggi rusumdagi aqlli kompyuter boshqaruv tizimini (TanStack Router) o‘rnatib, barcha datchiklarini (DevTools, Vite Plugin) markaziy panelga ulashimiz kerak.

TanStack Router bilan ishlashni boshlash uchun bor-yo‘g‘i 4 ta aniq qadamni bosib o‘tamiz.


O'rnatish va Ishga tushirish zanjiri

flowchart TD
    A["1. Paketlarni o'rnatish (npm / pnpm / yarn)"] --> B["2. vite.config.ts ga TanStackRouterVite plaginini ulash"]
    B --> C["3. src/routes/__root.tsx va index.tsx yaratish"]
    C --> D["4. npm run dev ishga tushishi bilan routeTree.gen.ts avtomatik paydo bo'ladi"]
    D --> E["5. main.tsx ga RouterProvider ulash"]

1-qadam: Kerakli paketlarni o'rnatish

Terminalni ochib, quyidagi paketlarni o‘rnatamiz:

# Asosiy kutubxona
npm install @tanstack/react-router

# Dasturchi vositalari va Vite plagini (Dev dependencies)
npm install -D @tanstack/router-devtools @tanstack/router-plugin

Har bir paketning vazifasi:

  • @tanstack/react-router: Marshrutlash, havolalar, loader va hooklarni o‘z ichiga olgan asosiy yadro kutubxona.
  • @tanstack/router-devtools: Brauzer burchagida marshrutlar, search parametrlar va kesh holatini ko‘rsatib turuvchi qulay vizual panel.
  • @tanstack/router-plugin (yoki @tanstack/router-vite-plugin): Fayl strukturangizni kuzatib, avtomatik ravishda routeTree.gen.ts faylini generatsiya qilib turuvchi Vite plagini.

2-qadam: Vite plaginini ulash (vite.config.ts)

Vite o‘z-o‘zidan TanStack Router fayllarini skaner qila olmaydi. Shuning uchun unga maxsus plaginni kiritib qo‘yamiz:

// vite.config.ts
import { defineConfig } from "vite";
import react from "@vitejs/plugin-react";
import { TanStackRouterVite } from "@tanstack/router-plugin/vite";

export default defineConfig({
  plugins: [
    // DIQQAT: TanStackRouterVite har doim react() plaginidan oldin turishi tavsiya etiladi!
    TanStackRouterVite(),
    react(),
  ],
});

3-qadam: Fayl tuzilmasini shakllantirish

File-based routing ishlashi uchun src/ papkasi ichida routes/ papkasini ochamiz va ikkita eng muhim boshlang‘ich faylni yaratamiz:

src/
├── routes/
│   ├── __root.tsx     # Barcha sahifalar uchun ota Layout (Navbar, DevTools)
│   └── index.tsx      # Bosh sahifa ("/")
└── main.tsx           # Router butun React ilovasiga ulanadigan kirish nuqtasi

A) Asosiy ota qobiq: src/routes/__root.tsx

Bu fayl har bir ochiladigan sahifaning ustki qobig‘i hisoblanadi (masalan: doimiy Navbar, Footer va bolalar chiqadigan joy):

// src/routes/__root.tsx
import { createRootRoute, Link, Outlet } from "@tanstack/react-router";
import { TanStackRouterDevtools } from "@tanstack/router-devtools";

export const Route = createRootRoute({
  component: RootComponent,
});

function RootComponent() {
  return (
    <>
      {/* 1. Umumiy Navigatsiya paneli */}
      <nav style={{ padding: "16px", borderBottom: "1px solid #e5e7eb", display: "flex", gap: "16px" }}>
        <Link 
          to="/" 
          style={{ textDecoration: "none", color: "#2563eb", fontWeight: "bold" }}
          activeProps={{ style: { textDecoration: "underline" } }}
        >
          Bosh sahifa
        </Link>
      </nav>

      {/* 2. Bola sahifalar aynan shu yerda almashadi */}
      <main style={{ padding: "20px" }}>
        <Outlet />
      </main>

      {/* 3. Ishlab chiqish uchun qulay DevTools oynasi */}
      <TanStackRouterDevtools position="bottom-right" />
    </>
  );
}

B) Bosh sahifa: src/routes/index.tsx

Bu "/" manziliga kirganda ko‘rinadigan bosh sahifadir:

// src/routes/index.tsx
import { createFileRoute } from "@tanstack/react-router";

export const Route = createFileRoute("/")({
  component: HomeComponent,
});

function HomeComponent() {
  return (
    <div>
      <h1>Xush kelibsiz! 🚀</h1>
      <p>Bu TanStack Router bilan qurilgan bosh sahifa.</p>
    </div>
  );
}

4-qadam: Routerni ilovaga ulash (main.tsx)

Loyihangiz terminalida npm run dev buyrug‘ini berishingiz bilan, Vite plagini src/ ichida routeTree.gen.ts faylini avtomatik yaratib beradi.

Endi main.tsx faylini ochib, routerni ulaymiz:

// src/main.tsx
import React from "react";
import ReactDOM from "react-dom/client";
import { RouterProvider, createRouter } from "@tanstack/react-router";

// Plagin yaratib bergan tayyor daraxtni import qilamiz
import { routeTree } from "./routeTree.gen";

// 1. Router instansiyasini hosil qilamiz
const router = createRouter({ routeTree });

// 2. TypeScript uchun Routerni global ro'yxatdan o'tkazamiz
declare module "@tanstack/react-router" {
  interface Register {
    router: typeof router;
  }
}

// 3. Ilovani render qilamiz
ReactDOM.createRoot(document.getElementById("root")!).render(
  <React.StrictMode>
    <RouterProvider router={router} />
  </React.StrictMode>
);

5. DevTools bilan tanishuv

Loyihani brauzerda ochsangiz (http://localhost:5173), pastki o‘ng burchakda TanStack Router logotipi tushirilgan kichik tugmani ko‘rasiz:

┌────────────────────────────────────────────────────────┐
│ TanStack Router DevTools                              │
├────────────────────────────────────────────────────────┤
│ Active Routes:                                         │
│  └── /__root                                           │
│       └── /                                            │
│                                                        │
│ Search Params: {}                                      │
│ Loader Data: None                                      │
└────────────────────────────────────────────────────────┘

Bu panel orqali siz:

  • Ayni paytda qaysi marshrutlar faol ekanligini;
  • URL search parametrlari qanday parse qilinganini;
  • Loader ma'lumotlari keshda qanday turganini bevosita ko‘rib turishingiz mumkin.

Muhim eslatmalar va Maslahatlar

[!WARNING] routeTree.gen.ts faylini qo‘lda tahrirlamang! Ushbu fayl boshida /* prettier-ignore-start */ va /* eslint-disable */ deb yozib qo‘yilgan. Siz src/routes/ papkasiga yangi fayl qo‘shsangiz yoki o‘chirsangiz, plagin bu faylni o‘zi qaytadan yozib beradi.

[!TIP] Agar yangi fayl yaratganingizda VS Code xatolik ko‘rsatsa yoki routeTree.gen.ts yangilanmay qolsa, shunchaki terminalda npm run dev ishlab turganiga ishonch hosil qiling va faylni bir marta Ctrl + S bilan qayta saqlang.


Xulosa

  • TanStack Router'ni Vite loyihasiga ulash atigi 4 ta qadamdan iborat: paketlarni o‘rnatish, Vite plaginini yoqish, __root.tsx layoutini tuzish va main.tsx da RouterProvider orqali ulab qo‘yish.
  • TanStackRouterVite plagini fayllar strukturasi asosida avtomatik ravishda TypeScript marshrutlar daraxtini hosil qiladi.
  • TanStackRouterDevtools esa dasturlash jarayonida marshrutlar va holatlarni real vaqtda kuzatib borishda eng yaxshi yordamchingizga aylanadi.