Skip to content

vscode-migration.md

Latest commit

 

History

History
252 lines (204 loc) · 4.9 KB

vscode-migration.md

File metadata and controls

252 lines (204 loc) · 4.9 KB

VS Code Migration to Nix

Date: December 15, 2025
Status: Ready for deployment

What Was Migrated

Your complete VS Code setup has been converted to a declarative Nix module!

Extensions (29 total)

  • ✅ GitHub Copilot + Chat
  • ✅ Python (Pylance, debugpy, path tools)
  • ✅ Elixir (ElixirLS, test runner, EEx formatter)
  • ✅ Go
  • ✅ C# / .NET (CSDevKit, C# extensions)
  • ✅ R language + syntax
  • ✅ Nix IDE
  • ✅ LaTeX Workshop + utilities
  • ✅ Terraform + HCL
  • ✅ Docker + containers
  • ✅ Markdown + Mermaid
  • ✅ Rainbow CSV
  • ✅ Makefile tools

Development Tools Detected

  • ✅ Node.js v22.12.0
  • ✅ Python 3.10.12
  • ✅ Go
  • ✅ Java 17
  • ✅ GCC/G++ 11.4.0
  • ✅ CMake 3.22.1
  • ✅ Docker 28.2.2
  • ✅ Terraform v1.14.0
  • ✅ AWS CLI v2.22.1
  • ✅ Git 2.34.1

How to Use

Enable in home.nix

programs.vscode = {
  enable = true;
  
  # All languages enabled by default (as per your setup)
  # Customize if needed:
  languageSupport = {
    python = true;
    elixir = true;
    go = true;
    csharp = true;
    r = true;
    nix = true;
    latex = true;
    terraform = true;
  };
  
  features = {
    copilot = true;
    docker = true;
    markdown = true;
  };
  
  # Add custom settings
  customSettings = {
    "editor.fontSize" = 14;
    "editor.fontFamily" = "'JetBrains Mono', 'Fira Code', monospace";
    # Any other preferences...
  };
};

Apply Configuration

home-manager switch --flake ~/git/home

What's Included

Automatic Setup

  • ✅ All 29 extensions installed
  • ✅ Language servers configured
  • ✅ Formatters installed
  • ✅ Sensible default settings
  • ✅ Format-on-save enabled
  • ✅ Language-specific settings

Preconfigured Settings

  • Editor: 2-space tabs, format on save, rulers at 80/120
  • Files: Auto-save after 1s, trim whitespace
  • Terminal: 10k scrollback
  • Git: Auto-fetch enabled
  • Telemetry: OFF
  • Python: Black formatter, Flake8 linting
  • Elixir: Dialyzer enabled, 2-space indent
  • Go: Auto-organize imports
  • Nix: nil language server, auto-format

Language Servers Included

  • Python: Pylance
  • Go: gopls
  • Nix: nil
  • Elixir: ElixirLS (via asdf)
  • R: languageserver
  • C#: Roslyn (via .NET SDK)

Benefits

Before (Manual Setup)

  • Install VS Code
  • Search and install 29 extensions manually
  • Configure each language
  • Install language servers
  • Set up formatters
  • Configure settings
  • Repeat on every machine 😫

After (Declarative Nix)

programs.vscode.enable = true;
home-manager switch

Done! ✅

Reproducible: Same setup on any machine
Version controlled: All in Git
Easy rollback: home-manager rollback
Customizable: Edit home.nix
No manual clicking: All automated

Customization Examples

Minimal Setup (Just Python)

programs.vscode = {
  enable = true;
  languageSupport = {
    python = true;
    # All others = false by default
  };
  features.copilot = false;  # No Copilot subscription
};

Add Custom Settings

programs.vscode = {
  enable = true;
  customSettings = {
    "editor.fontSize" = 16;
    "editor.fontFamily" = "'Cascadia Code', monospace";
    "workbench.colorTheme" = "Dracula";
    "editor.cursorStyle" = "line";
    "terminal.integrated.shell.linux" = "/usr/bin/zsh";
  };
};

Override Language Settings

programs.vscode = {
  enable = true;
  customSettings = {
    "[python]" = {
      "editor.rulers" = [ 100 ];  # Override default 88
      "editor.tabSize" = 4;       # Use 4 spaces
    };
  };
};

Migration Notes

Extensions Not in nixpkgs

Some extensions aren't available in nixpkgs yet. The module includes placeholders marked sha256-PLACEHOLDER. Home-Manager will auto-download these on first run.

If issues occur:

# Clear extension cache
rm -rf ~/.vscode/extensions

# Reinstall
home-manager switch --flake ~/git/home

Copilot Sign-In

GitHub Copilot requires sign-in after installation:

  1. Open VS Code
  2. Click Copilot icon
  3. Sign in with GitHub
  4. Accept permissions

Elixir Setup

Elixir language server requires Elixir + Erlang (handled by elixir.nix):

programs.elixir.enable = true;

Troubleshooting

Extension Not Installing

# Check Home-Manager logs
home-manager switch --flake ~/git/home --show-trace

Language Server Not Working

# Verify tool installed
which gopls    # Go
which nil      # Nix
which black    # Python formatter

Settings Not Applying

# Check generated settings
cat ~/.config/Code/User/settings.json

Next Steps

  1. ✅ Module created: home/modules/vscode.nix
  2. ⏭️ Add to home/home.nix imports
  3. ⏭️ Enable: programs.vscode.enable = true;
  4. ⏭️ Apply: home-manager switch
  5. ⏭️ Test: code ~/git/geckoforge

Your VS Code environment is now reproducible! 🎉

Every machine you deploy geckoforge to will have the exact same development setup.