Skip to main content

Migrate from Spec-Up to Spec-Up-T

Complete Migration Guide

For comprehensive migration instructions, see the spec-up-migrate documentation.

Quick Startโ€‹

If you have a Spec-Up installation and want to convert it to Spec-Up-T, use the migration tool:

# Navigate to your Spec-Up project directory
cd /path/to/your/spec-up-project

# Run complete migration
npx spec-up-migrate complete

# Test the migrated project
npm run menu

Why Migrate to Spec-Up-T?โ€‹

Spec-Up-T extends the original Spec-Up with powerful new features:

  • โœจ Enhanced Terminology Support: Individual term files with automatic definition management
  • ๐Ÿ”„ Modern Definition System: Use [[iref:]] inline references that automatically display current definitions
  • ๐Ÿ“– Multi-File Definition Extraction: Extract all [[def:]] definitions into organized term files
  • ๐ŸŽฏ Professional Output: Generate publication-ready HTML specifications
  • โšก Better Configuration: Dynamic configuration from the latest Spec-Up-T standards
  • ๐Ÿš€ Enhanced Developer Experience: Improved scripts, validation, and live development mode

Prerequisitesโ€‹

If you're running a Spec-Up installation, you already have most of what you need:

  • Node.js version 18 or higher (already installed if you have Spec-Up)
  • Terminal/Command Line access
  • Git (recommended for version control)
  • A text editor or IDE (Visual Studio Code recommended)
  • A web browser to view your specifications
Non-Technical Info
  • Command Line: A text interface to type commands for your computer
  • IDE: Software where you can easily write, test, and debug code
  • Node.js: The runtime that makes Spec-Up and Spec-Up-T work
  • Git: A system to track and manage changes in your code

What the Migration Tool Doesโ€‹

The spec-up-migrate tool provides enterprise-grade automation:

  • ๏ฟฝ Smart Detection: Automatically detect Spec-Up installations with 95%+ confidence
  • ๐Ÿ“ฆ Safe Backup: Create comprehensive backups before migration
  • ๐Ÿงน Clean Removal: Remove obsolete files and legacy dependencies
  • โšก Dynamic Configuration: Fetch latest Spec-Up-T configuration from official repository
  • ๐Ÿ”„ Intelligent Conversion: Convert legacy formats to modern Spec-Up-T structure
  • ๐Ÿš€ Complete Setup: Install Spec-Up-T with proper project structure
  • โœ… Validation: Built-in validation to ensure migration success

Learn Moreโ€‹

For detailed instructions, advanced features, troubleshooting, and command reference, see:

๐Ÿ“š Complete Migration Guide

Additional resources: