Установка фреймворка

До генерации модулей изучите карту архитектуры. Инструкция рассчитана на существующий проект SvelteKit 3. Kit не заменяет создание и настройку самого приложения SvelteKit.

Совместимость

Текущие peerDependencies Kit: SvelteKit >=3.0.0 и Svelte >=5.57.1. Миграция SvelteKit 3 также требует Node >=22.17, TypeScript >=6 и Vite >=8.0.12. Адаптер выбирайте под своё развёртывание. Эта документация соответствует локальной предварительной линейке Kit 6.x; старый npm dist-tag может ещё не содержать эти API.

pnpm add @azure-net/kit
pnpm add -D @azure-net/cli
# Необязательный UI-пакет
pnpm add @azure-net/ui-kit

Если нужная версия ещё предварительная, укажите её явно при установке. Сохраняйте lockfile в репозитории. Документация не предполагает, что определённый npm dist-tag уже опубликован.

Рекомендуемый путь: CLI fresh setup

Из корня проекта:

pnpm exec azure-net install fresh

Установщик создаёт структуру и предлагает примитивы ApplicationCore для response/datasource/schema/cookie, опциональный HttpProvider, переводы, обработчик ошибок, конфигурацию Prettier и Git hooks. Он создаёт program.ts и src/bootstrap/index.ts, подключая выбранные возможности. Middleware-классы генерируются отдельно, когда понадобятся.

Он не устанавливает Husky/commitlint/semantic-release и не заменяет всё приложение. Проверьте начальные настройки: URL датасоурса намеренно пуст, а общий шаблон ответа не может угадать контракт вашего API. Существующий пользовательский Bootstrap сохраняется; при необходимости CLI печатает инструкции подключения.

Далее:

pnpm exec azure-net folders-update
pnpm exec azure-net check project
pnpm dev

На старом проекте архитектурные проверки могут закономерно падать. Разбирайте указанные пути, а не отключайте проверки целиком. Для legacy-приложения начните с dry-run миграции, а не с генерации fresh поверх неизвестного кода.

Завершите подключение runtime

Проверьте Vite, program.ts и корневой layout. В частности, register() вызывается при инициализации компонента корневого layout: одни сгенерированные серверные хуки не заполняют состояние компонентов.

Затем пройдите пример композиции или используйте быструю генерацию CLI. Подключайте переводы и UI-kit по необходимости.