Svelte-Next

Automate Svelte Version Updates

This script automates updating Svelte versions in project directories. If you have multiple Svelte projects in subdirectories, this script will update them all.

Features:

• Automatic package manager detection (supports pnpm, npm, yarn, and bun)
• Updates Svelte to the specified version (defaults to "latest")
• Option to run package updates, integration/e2e tests, and git commands (git add, git commit, git push)
• Option to run in a debug mode
• Option to start at a certain index of project subdirectories
• Displays colored messages for informative progress

Requirements:

• One of the following package managers:
  • pnpm (default if no lock file found)
  • npm
  • yarn
  • bun
• git
• jq

Package Manager Detection

The script automatically detects which package manager to use based on the lock files present:

• bun.lockb → uses Bun
• pnpm-lock.yaml → uses pnpm
• yarn.lock → uses Yarn
• package-lock.json → uses npm
• If no lock file is found → defaults to pnpm

Installation

Install awesome package manager

curl -s https://raw.githubusercontent.com/shinokada/awesome/main/install | bash -s install

Add the following to your terminal config file, such as .zshrc or .bashrc.

export PATH=$HOME/.local/share/bin:$PATH

Then source the config file or open a new terminal tab.

# for example
. ~/.zshrc

Install svelte-next:

awesome install shinokada/svelte-next

Usage

# Install the latest and run package manager update, 
# test:integration and git add, commit, and push 
# if it is a git repo in subdirectories of the CURRENT directory.
svelte-next update .

# run the script in the ./Runes directory
svelte-next update ./Runes

# Use -v param to install a certain Svelte next version.
svelte-next update -v 5.x.x .

# Use -p flag to NOT run package updates:
svelte-next update -p .

# Use -s flag to NOT run updating svelte:
svelte-next update -s .

# Use -g flag to NOT run git add, commit, and push:
svelte-next update -g .

# Use -t flag to NOT run integration/e2e tests:
svelte-next update -t .

# Use -f <number> for starting index of subdirectory:
svelte-next update -f 3 .

# Use -d to run in debug mode:
svelte-next update -d .

# Combine the flags
svelte-next update -pg .
svelte-next update -pst .

# To display version: 
svelte-next --version

# To display help:
svelte-next -h | --help

Option list

-h --help: Displays help message.
-s: Skip running updating svelte.
-p: Skip running package updates.
-t: Skip running integration/e2e tests.
-g: Skip running git commands.
-d: Run in debug mode.
-f: Use -f for starting index of subdirectory
-v --version: version

Package Manager Commands Used

The script translates commands appropriately for each package manager:

Note:

• The script automatically detects and uses the appropriate package manager based on lock files
• The script assumes the target directory structure contains project subdirectories where Svelte is installed
• Ensure you have proper permissions to modify files and run git commands in the target directories
• If no lock file is found, the script defaults to using pnpm