🎯 Quick Start Tutorial - Life-Experimentalist/Global-Save-State GitHub Wiki

🎯 Quick Start Tutorial

Get up and running with Global Save State in just 5 minutes! This lightning-fast tutorial will have you saving and loading like a gaming pro.

⚡ 5-Minute Setup

Step 1: Install (30 seconds)

  1. Open VS Code
  2. Press Ctrl+Shift+X (Extensions)
  3. Search: "Global Save State"
  4. Click Install on VKrishna04's extension
  5. Done!

Step 2: Open a Project (30 seconds)

  1. Open any existing project, or
  2. Create a new folder with a simple file:
    // hello.js
    console.log("Hello, Save Points!");
  3. Open the folder in VS Code
  4. Ready!

Step 3: Create First Save (1 minute)

  1. Press Ctrl+Shift+S (the magic shortcut!)
  2. Enter name: "My First Save"
  3. Press Enter
  4. See success message: "Save point created!"
  5. Saved!

Step 4: Make Changes (1 minute)

Edit your file:

// hello.js
console.log("Hello, Save Points!");
console.log("I can experiment safely now!");

// Let's try something risky...
function breakEverything() {
    throw new Error("BOOM! 💥");
}

Step 5: Restore Save (1 minute)

  1. Press Ctrl+Alt+R (restore shortcut!)
  2. Select "My First Save" from the list
  3. Click to restore
  4. Watch the magic: Your file returns to the saved state!
  5. Restored!

Step 6: Victory! (1 minute)

🎉 Congratulations! You've mastered the basics:

  • ✅ Created a save point
  • ✅ Made experimental changes
  • ✅ Restored to a safe state
  • ✅ Ready for fearless coding!

🎮 Your First Gaming Session

Now let's practice with a realistic workflow:

Scenario: Building a Calculator

Round 1: Basic Calculator

  1. Create a new file calculator.js:

    function add(a, b) {
        return a + b;
    }
    
    console.log(add(2, 3)); // Should print 5
  2. Test it works → Run and verify output

  3. Save checkpoint: Ctrl+Shift+S"Basic Add Function"

Round 2: Add More Operations

  1. Add more functions:

    function add(a, b) {
        return a + b;
    }
    
    function subtract(a, b) {
        return a - b;
    }
    
    function multiply(a, b) {
        return a * b;
    }
    
    function divide(a, b) {
        return a / b;
    }
    
    console.log(add(2, 3));      // 5
    console.log(subtract(5, 2)); // 3
    console.log(multiply(4, 3)); // 12
    console.log(divide(10, 2));  // 5
  2. Test it works → Verify all functions

  3. Save checkpoint: Ctrl+Shift+S"All Basic Operations"

Round 3: Experiment with Advanced Features

  1. Try adding error handling:

    function divide(a, b) {
        if (b === 0) {
            throw new Error("Division by zero!");
        }
        return a / b;
    }
    
    // This might break things...
    console.log(divide(5, 0));
  2. If it breaks: Ctrl+Alt+R → Select "All Basic Operations"

  3. If it works: Ctrl+Shift+S"Error Handling Added"

Round 4: Try a Wild Experiment

  1. Attempt to add complex features:

    // Let's try to add scientific calculator functions
    function scientificCalculator() {
        // This is getting complicated...
        return Math.random() * Math.PI; // Random experiment!
    }
  2. Realize it's getting messy

  3. Restore to safety: Ctrl+Alt+R → Choose your preferred save

🏆 Mastery Challenges

Try these progressively harder challenges:

Challenge 1: The Save Chain

  1. Start with simple HTML: <h1>Hello</h1>
  2. Save as "Basic HTML"
  3. Add CSS: <style>h1 { color: blue; }</style>
  4. Save as "With CSS"
  5. Add JavaScript: <script>alert('Hello!');</script>
  6. Save as "Interactive"
  7. Practice jumping between saves!

Challenge 2: The Experiment Maze

  1. Create a working function
  2. Save as "Safe Base"
  3. Try 3 different improvements (save each)
  4. Deliberately break something
  5. Restore to "Safe Base"
  6. Choose the best improvement to continue with

Challenge 3: The Tutorial Race

  1. Find any coding tutorial online
  2. Save at the start: "Tutorial Beginning"
  3. Save after each major step
  4. If you get confused, restore to previous step
  5. Complete tutorial with confidence!

🎯 Pro Tips for New Players

Keyboard Shortcut Mastery

  • Ctrl+Shift+S = Create save (memorize this!)
  • Ctrl+Alt+R = Restore save (memorize this too!)
  • Ctrl+Shift+P = Command palette (backup method)

Naming Strategy

✅ "Working Login"        (clear what works)
✅ "Before API Changes"   (clear what's about to change)
✅ "Tutorial Step 3"      (clear progress marker)
❌ "Save 1", "Test"       (too vague)

When to Save

  • After completing something that works
  • Before trying something risky
  • At tutorial milestones
  • During broken/incomplete states

Gaming Mindset

  • Save often at good checkpoints
  • Experiment fearlessly - you can always reload
  • Name saves clearly - future you will thank you
  • Think in milestones - not every keystroke

🚀 Next Steps

🎉 You're now a Global Save State player!

Ready to level up?

❓ Quick Help

Not Working?

  • Check Extensions view - is Global Save State enabled?
  • Try Command Palette: Ctrl+Shift+P → "Global Save State"
  • See Troubleshooting for detailed help

Want More?


🎮 Welcome to the game! You're now equipped with the power of save states. Use them wisely, experiment boldly, and code fearlessly!

"Every expert was once a beginner who kept trying." - Gaming Wisdom

⚠️ **GitHub.com Fallback** ⚠️