Hacktoberfest 2026: những issue maintainer đã đánh dấu cho tháng Mười, đang mở và phù hợp người mới. Xem issue Hacktoberfest

Update to SvelteKit 3

Đang mở
  • Có gì không ổn?
#348 0 bình luận 0 reaction 0 người được giao Xem trên GitHub

Maintainer thường phản hồi trong vòng 1 ngày

Chưa có ai nhận issue này.

Đánh giá

Độ khó
5/5
Thời gian dự kiến
Hơn một tuần
Mức phù hợp với người mới
22/100
Loại issue
Tái cấu trúc
Độ rõ ràng
Khá rõ ràng
Mức độ hoạt động
Sôi nổi
Công nghệ
typescript
Lĩnh vực
documentation, frontend

Hướng nghiên cứu

This is a full SvelteKit 3 migration, not a first-issue. After the listed TypeScript/Vite upgrades, run npx sv migrate sveltekit-3, then follow the checklists: move adapter and vitePreprocess into vite.config.ts, retarget tsconfig.json extends, and rename $lib/$app imports. Touch the named call sites for goto/invalidateAll/handleError in src/hooks.server.ts, storage pages, and src/lib/storage/*.svelte.ts, then update AGENTS.md and helm env docs. Done when the app builds, env/zod, OIDC redirects, and forms behave under the new APIs.

Do mô hình lập chỉ mục viết ra từ nội dung của issue.

Mô tả

[!CAUTION]
This is not a complete list
And we should also wait for a few svelte patches before migrating

Prerequisit upgrades

  • TypeScript 5 to 6+
  • Vite 7 to 8

Auto migration

  • Run npx sv migrate sveltekit-3

Configuration

  • Delete svelte.config.js and move adapter() and vitePreprocess()
    into the sveltekit({ ... }) plugin options in vite.config.ts
  • tsconfig.json: change "extends" from "./.svelte-kit/tsconfig.json" to "$app/tsconfig"

Module aliases and imports

  • $lib → #lib
  • $app/environment → $app/env — 15 refs on main, 25 on the S3 branch

Environment variables

  • Rework all ENV vars to conform to the new env convention
  • Add zod schemas for every env

Navigation, forms and errors

  • goto() option invalidateAll → refreshAll, replaceState → replace. Affected:
    src/routes/(app)/storage/[bucket]/[...prefix]/+page.svelte:28 on main; on the S3 branch also
    storage/browse/[connection]/[bucket]/[...prefix]/+page.svelte:61,84 and storage/+layout.svelte:53
  • Standalone invalidateAll() → refreshAll(): src/lib/storage/state.svelte.ts:188,337,359
    plus archive.svelte.ts:236 and other call sites
  • Rework handleError at src/hooks.server.ts:94 — it now receives all errors including
    expected error() throws, so every 404/403 would currently be logged at error level and have
    its message replaced with "An unexpected error occurred". Discriminate on kind.
  • Review use:enhance forms — cross-page action now navigates automatically, and enhanced
    responses use the fail() status instead of always 200
  • Check external redirects still work — they now need { external: true } or an origin allowlist
    (relevant to the OIDC flow in src/routes/auth/)
  • $app/paths: Pathnames no longer start with /, which affects the
    PUBLIC_PATHS prefix matching in src/hooks.server.ts:46-55

Documentation

  • Update AGENTS.md — it documents $lib paths, the $env/process.env logging setup and the
    superforms rule, all of which change
  • Update deploy/helm/cockpit README and any env-var documentation
Ngôn ngữ chính
TypeScript
Star
1
Fork
0
Merge trung bình
3 ngày 20 giờ
Pull request đã merge (30 ngày)
14

Chuẩn bị môi trường

Dự án này không cung cấp dev container, Dockerfile hay hướng dẫn đóng góp, nên bạn cần tự thiết lập môi trường: hãy bắt đầu từ README và xem hướng dẫn đóng góp lần đầu của chúng tôi để biết các bước chung.

Bắt đầu từ đâu

  1. Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
  2. Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
  3. Fork repository và làm thay đổi trên một nhánh.
  4. Mở pull request có tham chiếu số hiệu của issue.

Issue khác của stackabletech/cockpit

Tất cả issue của stackabletech/cockpit

Issue tương tự

Thêm issue về TypeScript

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.