GUI TOOLS DOCUMENTATION

Complete guide for using LatticeVeil development and deployment tools

BUILD GUI

Purpose: Build and package LatticeVeil for distribution. Creates optimized builds for different platforms and configurations.
Location: Tools/BuildGUI.ps1

How to Use:

  • 1
    Launch the Build GUI

    Navigate to the Tools folder and run:

    .\BuildGUI.ps1
  • 2
    Select Build Configuration
    • DEBUG: Development build with debugging info
    • RELEASE: Optimized production build
    • LATEST: Most recent build available
  • 3
    Choose Target Platform
    • AUTO: Automatically detect from EXE path
    • DEV: Development deployment target
    • RELEASE: Production deployment target
  • 4
    Configure Build Options
    • Set output directory (DEV/RELEASE folders)
    • Choose compression settings
    • Configure include/exclude patterns
  • 5
    Execute Build

    Click "Build" to start the compilation process. Monitor progress in the output window.

💡 PRO TIP

The Build GUI automatically detects your project structure and suggests optimal settings based on your build history.

GATEHASH GUI

Purpose: Update live gate hashes for Supabase deployment. Manages runtime allowlists and deployment targets for your LatticeVeil instances.
Location: Tools/UpdateGateHashGUI.ps1

How to Use:

  • 1
    Launch the GateHash GUI

    Navigate to the Tools folder and run:

    .\UpdateGateHashGUI.ps1
  • 2
    Configure Gate URL
    • Default shows "https://YOUR_PROJECT.supabase.co/functions/v1" for new users
    • Click "Open Supabase" to visit your Supabase project
    • Enter your actual gate URL when ready
  • 3
    Enter Admin Token
    • Input your admin token
    • Click "Show" to toggle token visibility
    • Token is automatically saved to local config
  • 4
    Select Deployment Target
    • AUTO: Detect from EXE path automatically
    • DEV: Switch to DEV folder (auto-updates EXE path)
    • RELEASE: Switch to RELEASE folder (auto-updates EXE path)

    🔄 Auto-Switching: Changing targets automatically updates the EXE path to the correct folder!

  • 5
    Verify EXE Path
    • Path auto-switches when changing targets
    • Click "Browse" to manually select EXE if needed
    • Warning popup appears if EXE doesn't exist at expected path
  • 6
    Update Live Hash

    Click "Replace Live Hash" to:

    • Calculate SHA256 hash of your EXE
    • Update the gate allowlist with new hash
    • Set deployment target (dev/release)
    • Copy hash to clipboard automatically
⚠️ IMPORTANT SECURITY NOTES
  • Admin tokens and gate URLs are saved locally in Tools/gate.cfg
  • This file is protected by .gitignore and will NEVER be committed to the repository
  • Each developer has their own private configuration
  • New users see example URL - no sensitive data exposed in public repo
💡 AUTO-SAVE FEATURE

All settings are automatically saved instantly when you change them:

  • Typing in gate URL → Config saves
  • Typing admin token → Config saves
  • Switching targets → Config saves
  • Successful hash update → Config saves

UPDATE GATEHASH

Purpose: Command-line version of GateHash updater for automation and scripting. No GUI interface - perfect for CI/CD pipelines.
Location: Tools/UpdateGateHash.ps1

Command Line Usage:

.\UpdateGateHash.ps1 -GateUrl "https://YOUR_PROJECT.supabase.co/functions/v1" -AdminToken "your-token" -Target "release" -ExePath "path\to\exe"

Parameters:

  • -GateUrl: Your Supabase Functions base URL
  • -AdminToken: Your admin authentication token
  • -Target: Deployment target (auto/dev/release)
  • -ExePath: Path to the executable to hash
  • -NoUi: Run without GUI (default for this script)

Examples:

# Release deployment .\UpdateGateHash.ps1 -GateUrl "https://YOUR_PROJECT.supabase.co/functions/v1" -AdminToken "abc123" -Target "release" -ExePath "RELEASE\LatticeVeilMonoGame.exe" # Dev deployment .\UpdateGateHash.ps1 -GateUrl "https://YOUR_PROJECT.supabase.co/functions/v1" -AdminToken "def456" -Target "dev" -ExePath "DEV\LatticeVeilMonoGame.exe" # Auto-detect target .\UpdateGateHash.ps1 -GateUrl "https://YOUR_PROJECT.supabase.co/functions/v1" -AdminToken "xyz789" -Target "auto" -ExePath "bin\Release\LatticeVeilMonoGame.exe"

GENERAL INFORMATION

Folder Structure:

LatticeVeil_project/ ├── Tools/ # GUI tools location │ ├── BuildGUI.ps1 # Build interface │ ├── UpdateGateHashGUI.ps1 # GateHash GUI │ └── UpdateGateHash.ps1 # Command-line version ├── DEV/ # Development builds ├── RELEASE/ # Production builds └── LatticeVeilMonoGame/ # Main project

Configuration Files:

  • Tools/gate.cfg: GateHash GUI configuration (admin token, gate URL, target)
  • Protected by .gitignore: Never committed to repository
  • Auto-created: Generated when you first use the GUI tools

Security Best Practices:

  • Never share your admin tokens or gate URLs
  • Configuration files are local-only and protected
  • Use different tokens for dev and production environments
  • Regularly rotate your admin tokens

Troubleshooting:

  • PowerShell Execution Policy: Run Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
  • Missing EXE Files: GUI will warn you when EXE doesn't exist at expected paths
  • Gate Connection Issues: Verify gate URL and admin token are correct
  • Build Failures: Check output window for detailed error messages
← BACK TO MAIN SITE