Migrate To Rslib

Migrate to Rslib

Goal

Migrate tsc and tsup projects to Rslib with minimal behavior changes and clear verification.

Supported source frameworks

• tsc
• tsup

Migration principles (must follow)

1. Official guide first: treat Rslib migration docs as source of truth.
2. Smallest-change-first: complete baseline migration first, then migrate advanced or custom behavior.
3. Do not change business logic: avoid touching source or business logic unless user explicitly asks.
4. Validate before cleanup: keep old tool dependencies/config temporarily if needed; remove only after Rslib is green.

Workflow

1. Detect source tool

• tsup
• Config: tsup.config.*
• Dependency: tsup
• Build script: uses tsup to build projects
• tsc
• Config: tsconfig.json or tsconfig.*.json
• Dependency: typescript
• Build script: uses tsc to build projects. And it should be noted that tsc used only for type checking (e.g., tsc --noEmit) does not make it a tsc build project.

1. Apply tool-specific migration deltas

• tsc: references/tsc.md
• tsup: references/tsup.md

1. Validate behavior

• Run build command to verify the project builds successfully.
• If issues remain, compare the old project configuration with the migration guide and complete any missing mappings.

1. Cleanup and summarize

• Remove obsolete dependencies/config only after validation passes.
• Summarize changed files, mapped options, and any remaining manual follow-ups.

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: rstackjs
• Source: rstackjs/agent-skills
• License: MIT

Install and usage instructions live in the source repository linked above.