Release Notes

We strive to deliver updates fortnightly (bi-weekly), continuously improving the platform with new features, enhancements, and bug fixes. Each release consolidates changes across all platform components including CTMS, Sublink, Analytics, and supporting services.

v2.3.0 (15-Mar-2026)​

S3 Bundle Distribution & Token-Based Downloads

Bundle: bundle-v2.36.20260315

Download

https://zynomi-ctms.s3.us-east-2.amazonaws.com/zynctl-bundle-2.36.20260315.tar.gz?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential={credentials-received}

Need download credentials? Contact your Zynomi account representative or email contact@zynomi.com.

New Features

• S3 Bundle Distribution — Install bundles now automatically uploaded to a private S3 bucket as part of CI/CD, providing reliable and fast downloads
• Token-Based Download Access — Each client receives a unique, time-limited presigned download URL generated during onboarding
• Download Token GitHub Action — New Generate Download Token workflow in GitHub Actions for generating client download tokens with configurable expiry

Enhancements

• S3 region configuration corrected for bucket (us-east-2)
• Download token generator script with bundle listing and expiry control
• Updated installation docs to use S3 download URLs instead of GitHub Releases
• New Downloads & Deployment FAQ section (7 entries)

v2.2.0 (15-Mar-2026)​

Observability, Data Quality & Developer Experience

New Features

• Grafana Analytics Sidecar — Provisioning config (datasources, dashboards) shipped alongside the platform. Grafana (AGPL-3.0) is not bundled — operators pull the official image independently.
• Elementary Data Quality Reports — Daily dbt pipeline generates data-observability reports via Elementary (Apache-2.0). Elementary runs as a companion service and is not packaged inside the platform distribution.
• Frontend Developer Guide — Three-page architecture guide covering UI standards, naming conventions, error handling, and two worked CRUD examples
• CI/CD Documentation — Build Pipelines page and Installer Bundle & Versioning guide added to Developer Guide
• zynctl Post-Snapshot & Token Commands — New post-snapshot and refresh-token commands for day-2 operational workflows

Enhancements

• Consolidated zynctl.v1.sh → single zynctl.sh controller (removed legacy script)
• Practitioner creation: dynamic department dropdown + improved error handling
• UI improvements: dashboard error states, patient name display, login/signup titles
• Deployment Verification recipe with copy-paste test commands
• Frappe Token Refresh recipe and platform runbook updates
• Developer Guide sidebar restructure

Bug Fixes

• Fixed daily dbt pipeline to always generate Elementary companion reports
• Fixed HIV baseline staging model (result_of_cd4_count column mapping)
• Fixed ODM container DB_SSLMODE pass-through and data_analytics RBAC role
• Fixed login/signup page titles and practitioner creation error handling

Bundle v2.31 (08-Mar-2026)​

Patch — Force-Pull ctms-init Image

Bug Fixes

• Stale Docker Image Cache — zynctl.sh now runs docker compose pull ctms-init before up to avoid stale cached images

Bundle v2.30 (07-Mar-2026)​

Patch — Deployment Race Condition & Missing Item Groups

Bug Fixes

• Token Race Condition — Added Step 6b to zynctl.sh that waits for the Frappe setup container to exit before extracting the API token
• Missing Item Groups — ctms-init Stage 4 now creates "Laboratory" and "Drug" Item Groups before seeding Items
• Record Count Update — Stage 4 master data increased from 140 to 142 records

v2.1.0 (01-Mar-2026)​

Deployment Automation & Patient Workflows

New Features

• zynctl Bundle Controller — Single-command deployment controller with GitHub Actions CI workflow for automated bundle builds
• Patient Appointment Workflows — Reschedule and cancel appointments with full UI flow
• Structured API Logging — Middleware-level JSON logging for all /api/v1/* requests
• Demo Data Seeding — Self-contained seed-demo-data.sh script with patient seed containers
• Custom Branding — Volume-mounted branding assets for whitelabel deployments without rebuilds

Enhancements

• Renamed "Subjects" to "Patients" across all navigation and UI labels
• Calendar date picker: allow past dates for Sites fields
• Date formatting standardised to YYYY-MM-DD for Frappe API compatibility
• zynctl: Docker Hub login, env validation, seed-users command
• Comprehensive documentation overhaul: recipes, seed-and-init, custom branding, bundle deployment
• Developer Guide sidebar renamed from Architecture

Bug Fixes

• Fixed Patient Encounter creation in user/subject signup flows
• Fixed LaboratorySelect variable declaration order (ReferenceError)
• Fixed Docker-internal API URL leaking to browser
• Fixed doctype API route ignoring limit_page_length query param
• Fixed duplicate subject-study enrollment and null encounter on subject add
• Removed DLT ghost columns from dbt staging models

v2.0.0 (15-Feb-2026) 🎉​

Major Release — Single-Click Deployment & Pre-Built Images

New Features

• Single-Click Deployment — Automated install.sh script for full-stack deployment (Rocky Linux 10 compatible)
• Pre-Built Docker Images — All services now use CI/CD-built images (ctms-cube, ctms-api-gateway, supabase-seed, frappe-marley-health)
• Patient Composite API — New /api/v1/patient/[email] endpoint combining Patient and Address data

Enhancements

• Calendar date picker with UTC storage and local display
• Study Participants: Enhanced enrollment with duplicate prevention
• Comprehensive documentation overhaul (deployment guides, system requirements, platform runbook)
• Standardized .env.production naming convention
• Ghost column cleanup in data pipeline models

Bug Fixes

• Fixed calendar date picker save/display with UTC normalization
• Fixed duplicate subject-study enrollment and null encounter issues
• Fixed Cube API retry logic for 'Continue wait' responses
• Fixed Docker-internal API URL leaking to browser

v1.9.0 (01-Feb-2026)​

New Features

• Runtime Configuration — RUNTIME_* env override system for Docker deployments
• Self-Hosted Supabase — Complete on-premise Supabase stack with docker-compose
• CTMS Init Service — Dedicated Docker containers for Frappe provisioning (5-stage pipeline)
• CTMS Staffing Planner — Web app with optimistic/pessimistic scenario planning

Enhancements

• Refactored Signup and User Management flows
• Generic entity count API endpoint (ADR-003)
• Client-server URL separation for API calls
• Build-time branding args for whitelabel support
• Master data seed script with 83 records and 34 custom DocTypes

Bug Fixes

• Fixed Supabase URL priority (runtime over build-time)
• Fixed cubestore causing Cube 'Continue wait' hang
• Fixed duplicate CORS headers in Caddy configuration

v1.8.0 (18-Jan-2026)​

New Features

• GitHub Actions Pipelines — Automated Docker builds with 1.x versioning across all repositories
• OpenSpec Integration — Spec-driven development framework initialized in all projects
• Data Pipeline CI/CD — Full ingester workflow with dry-run support, caching, and notifications
• Unified Docker Stack — Single compose file with Caddy, observability & analytics profiles

Enhancements

• Studies module: Back button with pagination handling
• Dark overlay background when sheets are open
• User management: Active/Inactive status toggle
• Cube API URL configurable via environment variable
• DBT pipeline with Elementary data quality reports

Bug Fixes

• Fixed docker-entrypoint.sh permissions
• Fixed DATALAKE_APIS shell parsing issues
• Fixed Elementary command profile flags

v1.7.0 (04-Jan-2026)​

New Features

• Dynamic RBAC System — Configurable role-based access control with Frappe backend integration
• Study Export (ODM) — Export studies to CDISC ODM format (PDF/XML/HTML)
• Server-Side Pagination — Migrated data grids to server-side pagination for better performance
• My Studies/Subjects KPIs — Personalized dashboard KPIs for logged-in users
• Master Data JSON Config — Sidebar navigation loaded from JSON configuration
• Appointments Module (Sublink) — New appointments menu with modern flow
• Notifications Redesign (Sublink) — Modern notifications page with infinite scroll
• Partners & Pricing Pages — New company website pages with Cal.com integration

Enhancements

• RBAC Phase 3: Dynamic permissions with Frappe backend
• Study Designer read-only access to subject clinical data
• Study-specific filtering in MCP server for dashboard KPIs
• Elevated ProfileCard design in Sublink mobile app
• Environment-driven logo and Cal.com configuration on company website
• User-friendly validation messages on signup and user creation

Bug Fixes

• Fixed RBAC button visibility for Study Coordinator
• Fixed permissions checkbox display for missing records
• Fixed About modal close button in Sublink
• Fixed logo references from PNG to SVG on company website

v1.6.0 (14-Dec-2025)​

New Features

• MCP Chat Widget — Embeddable AI chat widget with theme presets, ChatGPT-style interface, and environment variable configuration
• Cube.dev Semantic Layer — Ad-hoc analytics playground with Docker Compose deployment
• MCP Server Deployment — REST bridge for AI assistant with Docker Compose hosting and DNS setup
• Dynamic Dashboards — Real-time KPI dashboards served through Cube.dev semantic layer

Enhancements

• Users module with full CRUD operations
• Signup role assignment restricted to Patient only
• Data quality checks for study dates in analytics pipeline
• Environment variables standardized across all projects

Bug Fixes

• Fixed data anomalies in dashboard metrics
• Fixed table prefix issues in data pipeline
• Fixed heading formatting in documentation

v1.5.0 (06-Dec-2025)​

New Features

• Role-Based Access Control (RBAC) — Guard rails for sites, action buttons, and feature flags
• Dynamic Logo Support — Configurable branding with environment variables
• Documentation Site — New Docusaurus-based documentation portal with API reference

Enhancements

• Major refactor from "Patients" to "Subjects" terminology
• Permission system improvements for Study Designer role
• Signup support for multiple roles
• New API menu and style refactoring
• Logo management documentation added

Bug Fixes

• Fixed access control issues reported by QA team
• Fixed CVE-2025-55182 security vulnerability
• Fixed layout wrapper and minimatch issues

v1.4.0 (29-Nov-2025)​

New Features

• Data Lakehouse Pipeline — Initial dbt pipeline with Cube.dev integration
• Data Ingestion Service — DLT Hub-based data pipeline for clinical trial data

Enhancements

• Drug Master changed to new doctype "Concomitant Medication"
• Study CRF and Study Sites view screens standardized
• Date formatting (DD-MMM-YYYY) applied across all screens
• Calendar popover close behavior improved
• FAQ and Glossary pages added to documentation

Bug Fixes

• Fixed date picker calendar year limits for better UX
• Fixed date range validator with improved user experience

v1.3.0 (22-Nov-2025)​

New Features

• Blog Section — Added blog page with code editor color theme
• Change Password — Self-service password change with fallback redirect

Enhancements

• Controlled menu navigation based on user roles
• Future date selection enabled for non-DOB date fields
• Documentation refactored and organized

Bug Fixes

• Fixed sidebar background color issue
• Fixed blog page rendering
• Fixed about popup display

v1.2.0 (17-Nov-2025)​

New Features

• Internal API Layer — All APIs now served locally, removed KrakenD dependencies
• New Signup Endpoints — Separate endpoints for user and subject registration

Enhancements

• REST API client documentation compatible with Postman and OpenAPI spec
• API documentation refactoring
• GitHub Actions for Docker builds
• Login page set as homepage

Bug Fixes

• Fixed Docker build issues
• Fixed GitHub Actions build configuration
• Fixed login button color

v1.1.0 (14-Nov-2025)​

New Features

• Access Control & Authorization — Role-based access introduced
• Study Personnel Module — Manage study team members
• Dashboard Prototype — Initial dashboard implementation

Enhancements

• ActionGuard component for permission-based UI controls
• React Day Picker upgraded to v9.11.1 with dropdown selectors
• Dashboard title modifications

Bug Fixes

• Fixed add button issues in Sites and Personnel modules
• Fixed role name display in Study Personnel
• Fixed X button behavior (application standard)

v1.0.0 (07-Nov-2025)​

New Features

• Subject CRF Module — Dynamic form generation for Case Report Forms
• Adverse Events Module — Capture and track adverse events
• Laboratory Module — Lab test prescriptions with dropdown selection
• Concomitant Medication — Drug prescription management

Enhancements

• Unified card view across patient and study modules
• Patient demographics update capability
• Country master dropdown pagination
• Study participant location capture with validation

Bug Fixes

• Fixed consent save with full subject name
• Fixed physical examination with full patient name
• Fixed family medical history name validation
• Fixed vital signs missing attributes

v0.9.0 (13-Oct-2025)​

New Features

• Patient Self-Signup — Form-based patient registration
• Dynamic CRF Forms — Human-readable field labels generated automatically

Enhancements

• Month and year selection enabled on date pickers
• React date picker with template design
• Signup UI improvements

Bug Fixes

• Fixed CRF form readability
• Fixed calendar UI issues

v0.8.0 (28-Sep-2025)​

New Features

• Study CRF Implementation — Link CRFs to studies and subjects
• CRF CRUD Operations — Add, edit, view, list, and delete CRF entries

Enhancements

• CRF listing based on Study and Subject
• Dynamic form field generation with proper structure
• Read-only forms positioned at top of sheets

v0.7.0 (25-Aug-2025)​

New Features

• Drug Prescription Module — Add and manage drug prescriptions
• Laboratory Listing — View and manage lab tests

Enhancements

• Drug dropdown excludes existing list items
• Enhanced drug prescription list with accurate details
• Frappe proxy APIs added

Bug Fixes

• Fixed laboratory form with lab test dropdown
• Removed console logs and debuggers

v0.6.0 (09-Aug-2025)​

New Features

• Patient Module — List and add patients
• Encounter Creation — Automatic encounter creation on participant addition

Enhancements

• Timestamp added to patient list to avoid cache issues
• Location dropdown moved under search field for bulk operations

Bug Fixes

• Fixed edit patient functionality

v0.5.0 (27-Jul-2025)​

New Features

• Business Glossary — Platform terminology reference
• Study Participant Details — Tabbed interface for participant data

Enhancements

• Standardized card views for subject and study modules
• Elevated card view design
• Enhanced glossary presentation layer

Bug Fixes

• Fixed issues in study participant detailed tabs