Hacktoberfest 2026：メンテナが10月に向けて印を付けた、オープンで初心者向けの issue。 Hacktoberfest の issue を見る

Update to SvelteKit 3

オープン
  • 何か問題がありますか？
#348 コメント 0 件 リアクション 0 件 担当者 0 名 GitHub で見る

メンテナーはふだん 2 日以内に返信

まだ誰も着手していません。

評価

難易度
5/5
見積もり時間
1週間以上
初心者へのやさしさ
22/100
issue の種類
リファクタリング
明瞭さ
おおむね明確
活発さ
活発
技術スタック
typescript
領域
documentation, frontend

調査の方向性

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.

索引モデルが issue の本文から書いたものです。

説明

[!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
主要言語
TypeScript
スター
1
フォーク
0
平均マージ
4日 6時間
マージ済み PR（30日）
12

環境構築

このプロジェクトには開発コンテナ、Dockerfile、コントリビューションガイドがありません。まず README を読み、一般的な手順ははじめてのコントリビューションガイドを参照してください。

はじめの一歩

  1. issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
  2. 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
  3. リポジトリをフォークし、ブランチを切って変更します。
  4. issue 番号を参照したプルリクエストを送ります。

stackabletech/cockpit のほかの issue

stackabletech/cockpit の issue をすべて見る

似ている issue

TypeScript の issue をもっと見る

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。