📦 Release Overview​

🎯 Client 0.1.2​

15 features, 3 infrastructure, 21 fixes

Highlights​

• Marketplace — browse and install models, template packs & config
• Show which templates apply to an entity
• Zoom-level attribute detail on large viewpoints
• Model-Level Custom Properties

• Bonsai Runs Quality Rules & SQL
• Wizards show what they will change on existing objects
• Column picker grouped by entity, and renaming without the mouse

→ View Client 0.1.2 Release Details

🎯 API 0.1.2​

3 infrastructure, 2 fixes

→ View API 0.1.2 Release Details

🎓 Summary​

ITB 0.1.2 is an umbrella release bundling the component changelogs above.

ITB 0.1.2 — August 28, 2026

📦 Release Overview​

🎯 Client 0.1.1​

19 features, 3 infrastructure, 7 fixes

Highlights​

• System Information Sections & License Details
• Richer auto-arrange (per-algorithm ELK options, direction & spacing, persisted defaults)
• Hide / show viewpoints & entity groups in the left sidebar
• In-app documentation follows the UI language

• Configurable Copy-with-Relation Wizard
• Create Entities from JSON (Canvas Background Menu)
• Duplicate Viewpoint + Duplicate Entity name form
• Import & sync externally-managed data

→ View Client 0.1.1 Release Details

🎯 API 0.1.1​

1 infrastructure

→ View API 0.1.1 Release Details

🎓 Summary​

ITB 0.1.1 is an umbrella release bundling the component changelogs above.

ITB 0.1.1 — August 27, 2026

📦 Release Overview​

🎯 WebApp 0.1.0​

• Entity name middle truncation for long names
• Duplicate entity via context menu
• Breaking: IndexedDB replaces PocketBase — one-time model migration required

→ View WebApp 0.1.0 Release Details

🎯 API 0.1.0​

• Git push/pull for model exchange
• Git origin tracking with optimistic locking
• Template artifact export as zip
• Generate-all cleans stale output before re-generating
• URL pattern/scheme cleanup
• Removed legacy PocketBase and Data Vault routers

→ View API 0.1.0 Release Details

⚠️ Upgrade Notes​

Breaking Changes​

• WebApp: The storage backend has changed from PocketBase to IndexedDB. Existing users must perform a one-time model migration after upgrading.
• API: The legacy PocketBase and Data Vault routers have been removed. Clients depending on those endpoints must migrate to the new Git-based and standard model endpoints.

ITB 0.1.0 — March 25, 2026

📦 Release Overview​

This release bundles significant improvements across components:

🎯 WebApp 0.0.8​

7 UI/UX Features + Comprehensive Performance Optimization

Highlights​

🎯 Advanced Workflows​

• ✨ Drag Entity from Sidebar to Canvas - Intuitive drag-and-drop entity placement
• ✨ Drag & Context Menu for Related Entities - Explore relationships without sidebar searching
• ✨ Comprehensive Canvas Context Menus - Right-click actions for entities, edges, and canvas
• ✨ User Settings Dialog - Centralized preferences for language, theme, canvas behavior, and grid
• ✨ Generate All Artifacts Button - One-click artifact generation with progress tracking
• ✨ Entity Tree Auto-Reveal - Canvas selection automatically reveals and scrolls to entity in sidebar

⚡ Performance​

• ⚡ Canvas Rendering Performance Boost - 60%+ render time reduction for large viewpoints
  • Viewport culling: Only visible elements rendered
  • Shared data maps for entity types and attributes
  • Lazy edge labels (hidden below 50% zoom)
  • Singleton dialogs: One instance for entire canvas
  • Cached handle positions for edge routing
  • Debounced viewpoint switching batched via requestAnimationFrame
  • Result: Large 30-entity, 40-edge viewpoints now render in under 10 seconds (vs. ~25 seconds)

→ View WebApp 0.0.8 Release Details

🎓 Summary​

ITB 0.0.8 is a focused update that improves day-to-day modeling workflows and responsiveness. The 7 UI features reduce interaction overhead, and the 60%+ rendering improvement makes larger viewpoints easier to work with in regular usage.

Key Achievements:

• ✅ Intuitive drag-and-drop workflows
• ✅ Context-aware actions reduce clicks
• ✅ Customizable workspace settings
• ✅ 60%+ performance improvement
• ✅ Large models now production-ready

⚠️ Upgrade Notes​

Recommended Actions​

1. Backup your current workspace: Export any critical models before upgrading
2. Clear browser cache: Some CSS and layout changes may require cache refresh
3. Test large models: If working with models exceeding 50 entities, test the new performance improvements

Compatibility​

• ✅ Fully backward compatible with existing models
• ✅ Existing workspace configurations preserved
• ✅ Storage layout unchanged
• ✅ API format unchanged

🙏 Thank You​

Thank you to all contributors and users who shared feedback and tested pre-release versions. That input helped refine this release.

ITB 0.0.8 — March 20, 2026

📦 Release Overview​

This release bundles improvements across components and infrastructure:

🎯 WebApp 0.0.7​

8 UI Features & 2 Model Improvements

Highlights​

• ✨ Model Filter by Entity Type - Focus on relevant entity types
• ✨ Add Entity to Canvas Center - Improved entity placement
• ✨ Entity Usage Indicators - See where entities are used across viewpoints
• ✨ Edge Highlighting - Trace relationships at a glance
• ✨ Attribute Drawer - CTRL+4 for quick attribute access
• ✨ Save Canvas as Image - Export documentation
• ✨ Auto Arrange Canvas - Optimize layout automatically
• ✨ Resizable Left Sidebar - Flexible workspace
• 🎁 Mandatory Attribute Field - Better data modeling
• 🐞 Fixed Edge Routing - Proper visualization on collapse

→ View WebApp 0.0.7 Release Details

🚀 API 0.0.7​

Enhanced Traceability & Version Tracking

Highlights​

• 📋 Metadata Export File - Automatic _metadata.json with version info and statistics
• 🔍 /pb_info Endpoint - Query PocketBase version information

What's tracked:

• ITB frontend, API, and library versions
• Export timestamp
• Entity, relation, viewpoint, and node counts

→ View API 0.0.7 Release Details

🎓 Summary​

ITB 0.0.7 represents a significant milestone with improved usability, better model traceability, and enhanced data quality practices. The WebApp gains powerful productivity tools while the API adds comprehensive version tracking for compliance and diagnostics.

⚠️ Major Changes & Migration Guide​

🔄 Environment Configuration Changes​

The .env file has been updated with new configuration options. Action Required:

1. Backup your current .env file:

   cp .env .env.backup
   

2. Update to the new .env template:

   cp .env.example .env
   

3. Re-apply your custom settings from the backup file to the new .env

Key changes:

• New Traefik load balancer configuration variables
• Updated image tags for version 0.0.7
• New documentation container settings

🏗️ Architecture Updates​

1. Traefik Load Balancer (NEW)​

This release introduces Traefik as a local load balancer, providing a cleaner URL structure for development:

Local Access URLs:

• WebApp: http://itb.localhost (instead of port-based URLs)
• API: http://api.itb.localhost (instead of port-based URLs)
• Traefik Dashboard: http://traefik.localhost:8080 (optional monitoring)

Why this helps:

• Simplified development URLs
• Closer alignment with production architecture
• No need to remember port numbers
• Supports multiple projects running simultaneously

Setup: Your /etc/hosts file should include (already configured if using provided docker-compose):

127.0.0.1 itb.localhost
127.0.0.1 api.itb.localhost
127.0.0.1 traefik.localhost

2. Integrated Documentation Container (NEW)​

The ITB documentation is now packaged as an integrated container service running busybox with httpd webserver:

Access Documentation:

• Access directly: http://itb.localhost/docs
• Documentation is fully functional without external network calls

Benefits:

• Documentation always matches your deployed version
• Offline-friendly within your local/internal network
• No external dependencies
• Consistent documentation across teams

📋 Update Instructions​

For Existing Users​

Follow these steps to upgrade to ITB 0.0.7:

1. Backup your data:

   # Backup the current model
   save remote in the WebApp to export the Model to JSON
   Backup your Output / JSON Folder
   

2. Update your environment:

   # Stop current instance
   docker compose down
   
   # Pull latest itb version from GitHub
   git pull
   
   # Backup and update .env
   cp .env .env.backup
   cp .env.example .env
   # Re-apply your custom settings
   

3. Pull latest images and start:

   docker compose pull
   docker compose up -d
   

4. Verify the installation:

   • WebApp: http://itb.localhost
   • API: http://api.itb.localhost
   • Docs: http://itb.localhost/docs

🔧 Troubleshooting​

Issue: Containers not starting or old configuration persists​

If you encounter issues after upgrading, try the following steps to perform a clean start:

Option 1: Clean Restart (Recommended)​

Stop and remove all containers:

# Stop all running containers
docker compose down

# Verify no ITB containers are running
docker ps | grep itb
# (should return no results)

Remove the PocketBase data volume (⚠️ This will reset your database):

# List volumes to find pb_data
docker volume ls | grep pb_data

# Remove the volume
docker volume rm itb_pb_data
# (or adjust the name based on your project folder name)

Start fresh:

docker compose up -d

Option 2: If you need to preserve your data​

Stop containers but keep volume:

docker compose down

Then restart with the existing data:

docker compose up -d

Common Issues & Solutions​

Full Reset (Last Resort)​

If issues persist, perform a complete reset:

# Stop everything
docker compose down

# Remove all ITB-related containers
docker ps -a | grep itb | awk '{print $1}' | xargs docker rm -f

# Remove volume
docker volume rm itb_pb_data

# Clean up any dangling images (optional)
docker image prune -a

# Start fresh
docker compose up -d

⚠️ Warning: This will permanently delete your PocketBase data. Make sure you've exported your models first!

Thank you to all contributors and users who made this release possible!