Flexygo Core VS Code Extension

A Visual Studio Code extension for managing Flexygo Core product operations directly from your development environment.

Features

This extension provides two main commands for Flexygo Core product management:

1. Generate NuGets (flexygo.generateNugets)

• Generates custom NuGet packages for your Flexygo product
• Prompts for semantic version number (e.g., 1.2.3 or 1.2.3-beta.1)
• Validates version format before execution
• Automatic solution validation (checks for *.Backend, *.Frontend, *.Conf.Database projects)
• Integrated with Flexygo product-management tool
• Reference: Flexygo Documentation - Generate NuGet

2. Update Product (flexygo.updateProduct)

• Updates your Flexygo product to the latest version
• Confirmation dialog before execution
• Automatic solution validation (checks for *.Backend, *.Frontend, *.Conf.Database projects)
• Integrated with Flexygo product-management tool
• Reference: Flexygo Documentation - Update Product

How to Access Commands

The commands are accessible from three convenient locations:

1. Editor Title Bar (⭐ Recommended - Most Visual)

When you open a .sln (solution) file, you'll see two icon buttons in the editor title bar:

• 📦 Package icon - Generate NuGets
• ⬇️ Arrow Down icon - Update Product

Simply click the icon for the action you want to perform!

2. Command Palette (Best for Keyboard Users)

Press Ctrl+Shift+P (Windows/Linux) or Cmd+Shift+P (Mac), then type:

• Flexygo: Generate NuGets
• Flexygo: Update Product

3. Explorer Context Menu (Right-Click)

Right-click on any file or folder in the Explorer view to see Flexygo commands

Prerequisites

Before using this extension, ensure you have:

1. .NET SDK (for running .NET Global Tools)
2. Visual Studio Code (v1.75.0 or higher)
3. A Flexygo solution (open the solution folder in VS Code)

Note: The extension will automatically install or update Flexygo.Tools.Product to the latest version when you run commands, so you don't need to install it manually.

For Extension Development

• Node.js (v18 or higher)
• TypeScript (installed automatically with dev dependencies)

Installation

For Development/Testing

1. Clone or navigate to this repository:

   cd "C:\Codigo GIT\Flexygo\flexygo-core-vscode-extension"
   

2. Install dependencies:

   npm install
   

3. Compile the TypeScript code:

   npm run compile
   

4. Press F5 in VS Code to launch the Extension Development Host

For Production Use

1. Package the extension as VSIX:

   npm run package
   

2. Install the generated .vsix file:

   • In VS Code, go to Extensions view (Ctrl+Shift+X)
   • Click the ... menu at the top
   • Select "Install from VSIX..."
   • Choose the generated flexygo-core-vscode-extension-1.0.0.vsix file

Development

Project Structure

flexygo-core-vscode-extension/
├── src/
│   ├── extension.ts              # Main extension entry point
│   ├── commands/
│   │   ├── generateNugets.ts     # Generate NuGets command implementation
│   │   └── updateProduct.ts      # Update Product command implementation
│   └── utils/
│       └── processExecutor.ts    # Utility for executing external processes
├── out/                           # Compiled JavaScript output
├── .vscode/
│   ├── launch.json               # Debug configuration
│   └── tasks.json                # Build tasks
├── package.json                   # Extension manifest
├── tsconfig.json                  # TypeScript configuration
└── README.md                      # This file

Running and Debugging

1. Open the project in VS Code:

   code "C:\Codigo GIT\Flexygo\flexygo-core-vscode-extension"
   

2. Press F5 to start debugging

   • This will compile the code and launch a new Extension Development Host window
   • Set breakpoints in the TypeScript source files as needed

3. In the Extension Development Host:

   • Open the Command Palette (Ctrl+Shift+P)
   • Run the Flexygo commands
   • View output in the "Flexygo Core" output channel

Available NPM Scripts

• npm run compile - Compile TypeScript to JavaScript
• npm run watch - Watch for changes and compile automatically
• npm run package - Create a .vsix package for distribution
• npm run lint - Run ESLint on the source code

Making Changes

After modifying the source code:

1. The watch task will automatically recompile (if running)
2. Press Ctrl+R in the Extension Development Host to reload
3. Or press F5 again to restart the debug session

Configuration

How It Works

The extension uses the flexygo-product .NET Global Tool to execute operations:

Automatic Tool Management:

• Before each command, the extension automatically runs:

  dotnet tool update --global Flexygo.Tools.Product
  

• This ensures you always have the latest version of the tool
• If not installed, it will be installed automatically
• If already installed, it will be updated to the latest version

Generate NuGets:

flexygo-product nuget -s "SOLUTION_PATH" -v VERSION -c Release

• Uses the currently open workspace folder as the solution path
• Prompts you for the version number
• Uses Release configuration by default

Update Product:

flexygo-product update -s "SOLUTION_PATH"

• Uses the currently open workspace folder as the solution path
• Updates to the latest available Flexygo version (no version specified)

Important Notes

1. Open Your Solution: Always open your Flexygo solution folder in VS Code before running commands
2. Valid Flexygo Solution: The extension validates that your solution contains the required Flexygo project structure (*.Backend, *.Frontend, *.Conf.Database)
3. .NET SDK Required: Ensure .NET SDK is installed for the tool management to work
4. Automatic Updates: The extension automatically ensures the tool is up to date before each operation
5. Internet Connection: First-time installation or updates require internet connectivity
6. Working Directory: The extension uses the first workspace folder as the solution path
7. Output Logging: All commands log detailed output to the "Flexygo Core" output channel

Output and Logging

All command execution is logged to the Flexygo Core output channel:

• View → Output → Select "Flexygo Core" from the dropdown
• Shows command execution, stdout, stderr, and exit codes
• Helps with troubleshooting and debugging

Error Handling

The extension provides comprehensive error handling:

• Validation: Version numbers are validated before execution
• Progress notifications: Visual feedback during long-running operations
• Error messages: Clear, actionable error notifications
• Detailed logging: Full output in the Flexygo Core channel
• Exit codes: Proper handling of process exit codes

Troubleshooting

Extension doesn't activate

• Check VS Code version (minimum 1.75.0)
• Run npm install to ensure dependencies are installed
• Check the Output panel (Help → Toggle Developer Tools → Console) for errors

Commands not visible

• Reload VS Code window (Ctrl+R in Extension Development Host)
• Check that the extension is activated (look for "Flexygo Core extension is ready!" notification)

Process execution fails

• Verify flexygo-product is installed: Run flexygo-product --help in a terminal
• Check PATH: Ensure .NET Global Tools are in your PATH
• Reinstall if needed:

  dotnet tool uninstall --global Flexygo.Tools.Product
  dotnet tool install --global Flexygo.Tools.Product
  

• Open correct folder: Ensure you have a Flexygo solution folder open in VS Code
• Review output: Check the "Flexygo Core" output channel for detailed error messages

"No workspace folder open" error

• Open your Flexygo solution folder in VS Code (File → Open Folder)
• The solution folder should contain your .sln file

Tool not found error

• Verify installation: dotnet tool list --global | findstr Flexygo
• Check .NET SDK is installed: dotnet --version
• Restart VS Code after installing the tool

Contributing

When contributing to this extension:

1. Follow the existing code structure
2. Maintain TypeScript strict mode compliance
3. Add appropriate error handling
4. Update this README if adding new features
5. Test thoroughly in the Extension Development Host

References

• Flexygo Documentation
• VS Code Extension API
• VS Code Extension Samples

License

Copyright © 2026 Flexygo. All rights reserved.

Version History

1.0.0 (Initial Release)

• Generate NuGets command with version validation
• Update Product command with confirmation dialog
• Integrated output channel logging
• Error handling and progress notifications
• Context menu integration