Release Nest

Organize, track, and prepare Salesforce release files intelligently — directly inside Visual Studio Code.

Release Nest brings structure and clarity to metadata-driven release management by automatically grouping files, managing multiple releases, and maintaining clean, version-controlled release manifests.

🚀 Overview

Release preparation should be structured — not manual and error-prone.

Release Nest enables teams to:

• Organize files by metadata type
• Manage multiple parallel releases
• Maintain clean and consistent release manifests
• Prevent duplicate entries
• Keep everything workspace-contained and deployment-ready

All release data remains transparent, structured, and easy to audit.

✨ Core Features

📂 Seamless Workspace Integration

• Add individual files or entire folders to a release
• Remove files instantly when no longer needed
• Explorer context menu support
• Dedicated Activity Bar view

📦 Structured Release Management

• Create and switch between multiple releases
• Automatically group files by metadata type
• Infer metadata from project structure
• Normalize case to prevent duplicate entries

🔄 Flexible Sync Modes

Release Nest supports two sync behaviors:

• Manual Mode – Sync only when explicitly triggered
• Auto Mode – Automatically keep release metadata updated

Auto Mode ensures your release manifest stays continuously aligned with your selected files.

📁 Dual Storage Architecture

Release Nest maintains release data in two structured locations:

1️⃣ Primary Workspace Storage

All releases are stored inside your project: .release-nest/

Each release maintains its own structured Markdown manifest file, making it:

• Version-control friendly
• Transparent and reviewable
• Easy to audit
• Team-ready

This acts as your authoritative release source within the repository.

2️⃣ Destination Folder Copy (Optional)

You may configure a destination folder for your release files.

When configured:

• A copy of the release manifest is created in the destination.
• In Auto Mode, this copy updates automatically whenever changes occur.
• In Manual Mode, the destination copy updates only when sync is triggered.

Why Provide a Destination Folder?

The destination option exists to support:

• Sharing release manifests via cloud storage (OneDrive, Google Drive, SharePoint, etc.)
• Publishing release details to shared team locations
• Feeding external deployment or documentation systems
• Providing structured files to cloud-based release pipelines
• Collaborating with stakeholders who do not access the workspace directly

This dual-storage approach ensures:

• Developers maintain structured tracking inside the repository
• Teams can share and distribute release manifests externally
• Cloud-based workflows remain aligned with local development

It creates a clean separation between development tracking and distribution.

📑 Clean Grouped Output

Release Nest generates structured output like: ApexClass

• MyClass.cls
• MyHelper.cls

CustomObject

• Account.object

Ideal for:

• Change Sets
• Copado stories
• Deployment documentation
• Pull requests
• Release tracking
• Cloud-based collaboration

⚙ Configuration

Configure Release Nest via VS Code Settings:

Additional configurable options:

• Destination folder path
• Sync mode (Manual / Auto)

🏗 Typical Workflow

1. Create or select a release
2. Add files or folders from Explorer
3. Review grouped files in the Release view
4. Configure destination folder (optional)
5. Use Manual or Auto Sync
6. Share or deploy with confidence

🎯 Ideal For

• (Salesforce) development teams
• Metadata-driven projects
• Release managers
• Teams handling multiple ongoing releases
• Cloud-based collaborative environments

🔒 Secure & Local

• No external services
• No hidden automation
• No external dependencies
• Fully controlled within your workspace

📌 Summary

Release Nest transforms release preparation into a structured, reliable, and repeatable workflow — fully integrated into Visual Studio Code.

With intelligent grouping, multi-release management, and dual-storage sync architecture, Release Nest ensures your deployments remain organized, consistent, and ready for both local tracking and cloud-based collaboration.

Build releases with clarity.
Deploy with confidence.