Skip to content

Releases: jkarp7/showstack

v0.2.0-alpha

28 Mar 18:45
@github-actions github-actions
v0.2.0-alpha
6597fba

Choose a tag to compare

View all tags
v0.2.0-alpha Pre-release
Pre-release 
feat: prompt returning users to re-sign-in when session expires

Previously, users who had signed in before (authPrompted = true) but
whose session expired would land in the app with no sync and no
indication of why or how to fix it.

- handleSplashComplete: if authPrompted is set but isAuthenticated is
  false, open the login modal with isReturningUserPrompt = true (no
  Demo Mode option, just a login form)
- AuthModal: show "Your session has expired. Sign in to re-enable
  cloud sync." subtitle when isReturningUserPrompt is active
- authStore: add isReturningUserPrompt state; clear it on sign-in
  success and modal close

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Loading

v0.1.0-alpha

05 Jan 03:21
@github-actions github-actions
v0.1.0-alpha
a5aa1e8

Choose a tag to compare

View all tags
v0.1.0-alpha Pre-release
Pre-release

ShowStack v0.1.0-alpha - First Alpha Testing Release

Release Date: January 4, 2026
Build From: develop branch
Status: Pre-release (Alpha Testing)

🔧 Update (January 4, 2026)

Critical Fix: Resolved project navigation issue where clicking into a project would incorrectly show the home page instead of the project view in production builds.

Technical Details:

  • Switched from BrowserRouter to HashRouter to support Electron's file:// protocol in production
  • Updated window routing to use hash-based navigation (#/project/id)
  • This fix only affects production builds; development mode was unaffected

All builds below include this fix. If you downloaded an earlier version today, please re-download.

🎯 About This Release

This is the first alpha release of ShowStack for external testing and feedback. The application represents 90% completion of the Unified Visual Editor System, plus comprehensive power management and infrastructure enhancements.

Target Audience: Alpha testers, early adopters, and technical users comfortable with pre-release software.

✨ What's New in This Release

Unified Visual Editor System (90% Complete)

Phase 3: Paperwork Template System ✅

  • 13 Report Types with customizable templates
    • Fixture Reports (8): Channel hookup, dimmer schedule, circuit list, DMX addresses, power summary, color schedule, gobo schedule, color cut report
    • Infrastructure Reports (5): Equipment list, network summary, port assignments, power consumption, location map
  • Column Configuration UI with drag-and-drop reordering
  • Grouping & Sorting Controls for report organization
  • Color Swatch Visualization in Color Cut Report
  • Gel Color Database with 628 theatrical gels (GAM, LEE, Roscolux)
  • Template Library with save/load/duplicate functionality
  • Automatic Sheet Calculations for gel cutting lists

Phase 3.5: Logo & Image Support ✅

  • Image Upload with file browser (PNG, JPG, SVG, GIF support)
  • Base64 Storage for logos and graphics (2MB max per image)
  • Project Logo Integration in paperwork headers
  • ObjectFit Options (contain, cover, fill) for image scaling
  • PDF Export Support with Puppeteer rendering

Phase 4: Label Integration ✅

  • Grid-Based Visual Designer for label layouts (4 cells per inch precision)
  • 5 Avery Templates supported:
    • 5160: Address labels (3×10 grid, 2.625" × 1")
    • 5163: Shipping labels (2×5 grid, 4" × 2")
    • 5164: Shipping labels (2×3 grid, 4" × 3.33")
    • 8160: Address labels (3×10 grid, 2.625" × 1")
    • 5167: Return address labels (4×20 grid, 1.75" × 0.5")
  • 36 Fixture Data Fields for label customization
  • Background Color Picker with full color customization
  • Batch PDF Printing with multi-label sheet rendering
  • Automated Migration from legacy localStorage designs to database
  • Complete Documentation (617 lines) in codebase

Power Management & Infrastructure (Sprints 1-4)

Sprint 1: Power Foundation ✅

  • Building Service Assignment - Designate racks to Service A/B/C for load planning
  • Custom Phase Labels - Rename phases from A/B/C to 1/2/3 or custom names project-wide
  • Service Configuration Panel - Set capacity (amps) for each building service
  • Persistent Settings - Service configurations stored in settingsStore

Sprint 2: Phase Distribution Templates ✅

  • Template System for saving and loading phase configurations
  • Built-in Templates:
    • AB Phasing (Alternating): A, B, A, B, ...
    • AC Phasing (Alternating): A, C, A, C, ...
    • Three Phase ABC (Sequential): A, B, C, A, B, C, ...
  • Phase Template Editor with circuit-to-phase mapping
  • Apply Templates to racks with one click

Sprint 3: Infrastructure Enhancements ✅

  • Port Linking - Link infrastructure ports to:
    • Fixtures (by ID)
    • Other equipment (with port number)
    • Free text notes
  • Port Usage Tracking - Visual indicators showing port utilization
  • CSV Import/Export - Bulk import/export infrastructure equipment with field mapping UI
  • Enhanced Port Editor with link type persistence

Sprint 4: PDF Export Polish ✅

  • Color Mode Toggle for all PDF exports (Color vs Grayscale)
  • Default: Color printing enabled (user-configurable)
  • Grayscale Filter applied via CSS for B&W mode
  • Consistent Across All Exports - Paperwork, Shop Orders, Labels

UI/UX Improvements ✅

  • Settings Dialog Modal - Click-outside-to-close, no navigation disruption
  • Power Management Page - Standalone page with tabs (Racks, Configuration, Summary)
  • Equipment Manager "Power" Tab - Rack listing table with color-coded badges
  • Service Configuration UI - Add/remove services with capacity tracking
  • Improved macOS Window Focus - Better window management for project windows

🧪 What to Test

We're looking for feedback on:

Critical Functionality

  1. Project Navigation (NEW FIX)

    • Click into projects from the landing page
    • Verify project view loads correctly (not home page)
    • Test opening multiple project windows

  2. Label Designer

    • Create labels using the visual grid editor
    • Test all 5 Avery templates (5160, 5163, 5164, 8160, 5167)
    • Add images and customize background colors
    • Batch print multiple labels to PDF

  3. Service Configuration

    • Set up building services (Service A/B/C)
    • Assign racks to services
    • Configure phase templates and apply to racks
    • Verify custom phase labels appear in UI

  4. Port Management

    • Link infrastructure ports to fixtures and equipment
    • Test port usage tracking visual indicators
    • Import/export infrastructure via CSV

  5. Paperwork Generation

    • Create reports using template system
    • Customize column visibility and grouping
    • Export PDFs in both color and grayscale modes
    • Test Color Cut Report with gel database

General Testing

  • Overall app stability and performance
  • UI responsiveness and clarity
  • Feature discoverability
  • Error handling and edge cases
  • Cross-feature integration (e.g., fixtures → labels → paperwork flow)

📥 Installation Instructions (macOS)

Download

  1. Download ShowStack-0.1.0-alpha-arm64.dmg from the Assets section below

Install

  1. Open the DMG file - Double-click the downloaded DMG
  2. Drag to Applications - Drag "ShowStack" to the Applications folder icon

First Launch (Important!)

You will see a "damaged" error - This is actually a code signing issue, not corruption!

If macOS shows: "ShowStack" is damaged and can't be opened. You should move it to the Trash.

DO NOT move it to trash! This is Gatekeeper blocking unsigned apps. Use one of these methods:

Method 1: Right-Click to Open (Recommended)

  1. Open Finder → Applications
  2. Right-click (or Control+click) on "ShowStack"
  3. Select "Open" from the context menu
  4. Click "Open" in the security dialog that appears

Method 2: Remove Quarantine (Alternative)

Open Terminal and run:

xattr -cr /Applications/ShowStack.app

Then launch the app normally.

Why This Step?

This alpha build is not code-signed with an Apple Developer certificate ($99/year). macOS Gatekeeper blocks unsigned apps by default to protect users. The "damaged" message is misleading - the app is fine, just unsigned.

Only needed once - After the first launch, the app works normally (double-click).

⚠️ Known Limitations

This is an alpha release - please expect:

Not Yet Implemented

  • ❌ Auto-updates (manual download required for future versions)
  • ❌ Phase 5: Polish & UX features (keyboard shortcuts, inline editing, shadows)
  • ❌ Code signing (requires Apple Developer certificate)
  • ❌ Multi-user collaboration (planned for future)
  • ❌ Vectorworks/MVR integration (planned for beta)
  • ❌ Console integration (ETC Eos, grandMA - planned for beta)

Expected Rough Edges

  • Some UI polish items remain (Phase 5 scope)
  • Error messages may not be comprehensive
  • Performance optimizations pending
  • Documentation is developer-focused (user manual coming later)

Platform Limitations

  • Multi-platform support: macOS (ARM64), Windows (ARM64), Linux (ARM64)
  • macOS tested on 12.0+ (Monterey and later)
  • Windows/Linux builds are unsigned (similar Gatekeeper-style warnings may appear)
  • Requires Node.js 20+ if running from source

🗑️ Complete Removal (If Needed)

If you need to uninstall ShowStack completely:

# Delete the application
rm -rf "/Applications/ShowStack.app"

# Delete all user data (projects, settings, databases)
rm -rf ~/Library/Application\ Support/ShowStack/

# Delete application preferences
rm -rf ~/Library/Preferences/com.lytrix.showstack.plist

# Verify removal
ls -la ~/Library/Application\ Support/ | grep -i showstack

Note: This removes all projects and settings. Export any projects you want to keep first.

📝 Providing Feedback

We'd love to hear from you! Please report:

Bug Reports

Feature Requests & Suggestions

What We're Looking For

  • ✅ Critical bugs or crashes
  • ✅ UX friction points
  • ✅ Missing features that block workflows
  • ✅ Performance issues
  • ✅ Unclear UI/labeling
  • ✅ General usability feedback

📊 Technical Details

Build Information

  • **Versi...
Read more
Loading