> For the complete documentation index, see [llms.txt](https://fias.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://fias.gitbook.io/docs/readme.md).

# FIASga xush kelibsiz!

**Fias** – zamonaviy va moslashuvchan starter kit bo‘lib, sizning loyihalaringizni eng yaxshi amaliyotlar va zamonaviy vositalar bilan tez va ishonchli tarzda boshlash uchun mo‘ljallangan.

Bu hujjatlarda **GitBook’ning eng yaxshi imkoniyatlari**ni amalda ko‘rasiz va bu shablonni qanday qilib o‘zingizga moslashtirish haqida foydali ma’lumotlarga ega bo‘lasiz.

***

### ✨ FIAS nima?

FIAS — bu **ochiq manbali starter kit** bo‘lib, **React** va **Next.js** kabi zamonaviy texnologiyalar yordamida kuchli va kengaytiriladigan veb-ilovalarni yaratish uchun ishlab chiqilgan.

U barcha kerakli vositalar bilan jihozlangan — siz loyihangizni ishonch bilan boshlashingiz va kengaytirishingiz uchun zarur hamma narsa tayyor.

Barcha shablonlar **TypeScript** asosida tuzilgan va **Feature-Sliced Design (FSD)** arxitekturasi bo‘yicha tashkil etilgan.

Yangi loyiha yaratish uchun bir necha soniya kifoya:

```
npx create-fias
```

Siz **React** yoki **Next.js** bilan ishlayotgan bo‘lsangiz ham, FIAS ikkala yo‘nalish uchun tayyor andozalarni taqdim etadi — barchasi **TypeScript** asosida ishlaydi.

***

### 🤔 Nega aynan FIAS?

* 🔄 Doimiy yangilanadi va yangi funksiyalar qo‘shib boriladi
* ✅ Muhim vositalar oldindan sozlangan (ESLint, Prettier, Husky)
* 💅 Kuchli UI stack: **Tailwind CSS** va **Shadcn UI**
* 🌗 Mavzular: **yorug‘ / qorong‘i** (light/dark)
* 🌍 Tilni qo‘llab-quvvatlash (i18next)
* 🔧 Foydali util’lar va maxsus hook’lar
* 🛡️ Git hook’lar: har bir `commit` va `push` oldidan kod sifatini tekshiradi

***

### ⚙️ Ichida nima bor?

#### 🧱 Next.js Template

* App Router asosidagi tuzilma
* Tez build uchun **Turbopack**
* ESLint + Prettier oldindan sozlangan
* Husky bilan:
  * `pre-commit`: lint va format
  * `pre-push`: build’ni tekshirish
* Tailwind CSS + Shadcn UI
* Yorug‘ / qorong‘i mavzu
* Tilni avtomatik aniqlovchi i18n (i18next)
* API chaqiruvlar: **@tanstack/react-query** va **axios**
* Qayta ishlatiladigan hook’lar: `useCloser`, `useMobile`, `useWindowSize` va boshqalar
* Foydali util’lar: `formatDate`, `formatPhone`, `formatPrice` va boshqalar

***

#### ⚛️ React Template

* ESLint + Prettier oldindan sozlangan
* Husky bilan:
  * `pre-commit`: lint va format
  * `pre-push`: build’ni tekshirish
* Tailwind CSS + Shadcn UI
* Yorug‘ / qorong‘i mavzu
* i18next orqali ko‘p tillilik
* API chaqiruvlar: **@tanstack/react-query** va **axios**
* Qayta ishlatiladigan hook’lar: `useCloser`, `useMobile`, `useWindowSize` va boshqalar
* Foydali util’lar: `formatDate`, `formatPhone`, `formatPrice` va boshqalar

***

### 🚀 Boshlashga tayyormisiz?

Chap paneldan kerakli bo‘limni tanlab hujjatlar bilan tanishing. Siz Next.js yoki React asosida ishlayotganingizdan qat’i nazar, **FIAS** sizga **ishlab chiqarishga tayyor** structurani taqdim etadi.