Lokalda ishga tushurish

FIAS ochiq manbali starter kit bo‘lib, React.js va Next.js asosida frontend loyihalar uchun mustahkam asos yaratadi. Quyidagi bosqichlar orqali siz FIAS loyihasini o‘z kompyuteringizda ishga tushirishingiz mumkin.

📦 Repository manzili: https://github.com/fiasuz/fias-ui

1. Repository’ni klon qiling

Terminalni oching va quyidagi buyruqni bajaring:

git clone https://github.com/fiasuz/fias-ui.git
cd fias-ui

💡 SSH orqali klon qilish:

git clone [e-mail]:fiasuz/fias-ui.git
cd fias-ui

2. Templateni tanlang (branch)

FIAS loyihasi ikki asosiy template’ni qo‘llab-quvvatlaydi:

• templ-next — Next.js uchun

• templ-react — React.js uchun

Ishlamoqchi bo‘lgan template uchun mos branchdan yangi branch oching:

▶️ Next.js uchun:

git checkout -b my-feature-name origin/templ-next

▶️ React.js uchun:

git checkout -b my-feature-name origin/templ-react

📝 Eslatma:

• Hech qachon bevosita templ-next yoki templ-react branchlariga push qilmang.

• Har doim o‘z branch’ingizda ishlang (feature/your-feature-name kabi).

3. Packagelarni o'rnating (npm install)

FIAS npm bilan to‘liq moslangan. Paketlarni o‘rnatish uchun quyidagilarni bajaring:

npm install

Agar sizda .npmrc fayl mavjud bo‘lsa (masalan, private registry uchun), iltimos, uni ham sozlang.

4. Lint va formatni ishga tushiring (ixtiyoriy)

Kod sifati muhim. Quyidagi buyruqlar bilan loyihani tekshirishingiz mumkin:

npm run lint
npm run prettier

Eslint va Prettier avtomatik sozlangan. Husky orqali commit qilishdan oldin bu jarayonlar avtomatik ishga tushadi. Agar xatolik aniqlansa, commit bekor qilinadi.

5. Loyihani ishga tushiring

Development serverni ishga tushirish uchun:

npm run dev

Brauzerda oching: http://localhost:3000

Agar boshqa port ishlatilgan bo‘lsa, terminalda ko‘rsatiladi.

✅ Tabriklaymiz! Siz FIAS loyihasini lokalda ishga tushirdingiz.

Endi siz:

• yangi funksiyalar yaratishingiz,

• mavjud kodni optimallashtirishingiz,

• foydali hook yoki util funksiyalar qo‘shishingiz,

• hujjatlarni boyitishingiz mumkin.

Pull Request ochishdan oldin commit va push skriptlar orqali avtomatik build va lint tekshiruvlari bajariladi.