Skip to main content
CYPEX Documentation
Support
v2.0.0 Latest stable release View changelog ->

Boolean Input

An interactive input that can render as a checkbox, a switch, or a button with custom text labels, colors, and layout placements.

When to use

  • User needs to toggle a binary value (true/false) or select a tri-state value (true/false/null) inside a form.
  • Providing toggle switches, checkbox inputs, or toggle button behaviors for boolean form parameters.

What you need

Requires a parent Form context (default_form) on the page to resolve the Data Source connection (Element ID and Field Path).

Read full post

Pie Chart

A dynamic circular pie or donut chart visualizing categorical proportional shares, complete with slice value labels, customizable empty state colors, theme palettes, and interactive toolbox utilities (image export, clear selection, data view table).

When to use

  • Visualizing proportional distributions, parts-of-a-whole relationships, or percentage share compositions.
  • Displaying dynamic categorical datasets where each slice’s volume contributes to a total 100% sum.

What you need

Requires an active Source Query. Select a valid column property for Label (defines pie slices) and a numerical column for Value (defines slice volume). Every label field must map to a valid numeric value.

Read full post

Release Notes v1.9.2

Features

  • New Input Elements:

    • Code Field: New code input element for code editing
    • Radio Button Input: Added radio button input element for single-choice selections
    • Interval Input: Enhanced interval data type support across the platform
  • UI Components & Layout:

    • Icon Element: Configurable icon element with customization options
    • Background Image Support: Added background image configuration for UI pages
    • Configurable Default Container: Enhanced default container with adjustable configuration
    • Modal Button Configuration: Added hidden state and size settings to modal buttons
    • Enhanced Conditional Container: Added toggle functionality to conditional containers
  • Data Visualization & Charts:

Read full post

Boolean Field

A read-only checkbox representing the output evaluation of a boolean expression.

When to use

  • Presenting simple binary flags or states (true/false) to users.
  • Evaluating conditional dynamic expressions that resolve to a boolean or null value.

Examples

  • Displaying a read-only checkbox representing an active/inactive record state.
  • Evaluating checkmark UI indicators using conditional true/false/null backend logic.

Avoid

  • Using for interactive form inputs where users need to check or uncheck a box to submit data, use boolean_input instead.
  • Allocating large layout grid dimensions (e.g., spanning multiple rows or wide column blocks), keep this compact display element restricted to 1 row height and 1 to 2 grid columns.
  • Writing complex string or object expressions in the booleanExpression textbox instead of resolving directly to boolean values (true, false) or null.

Editor properties

Configure these in the Application Designer property panel. Group headings mirror the editor where possible. Data Source is where the element gets its rows or field binding (a view/query, a connector operation, or a parent form field). References appear only for view-backed sources and map foreign-key ID columns to readable labels from another view.

Read full post

Code Input

A code editor bound to a form field, with syntax highlighting for the configured language.

When to use

  • Editing a stored snippet, template or query where indentation and highlighting matter.

Examples

  • Editing an email template stored on the record.

Avoid

  • Using it for structured JSON that should be validated — a JSON Input reports parse errors.
  • Using it for short single-line values, where the editor chrome outweighs the benefit.

Use instead

Read full post

CYPEX Release Notes

This section contains detailed release notes for all CYPEX versions, documenting new features, enhancements, bug fixes, and technical improvements in each release.

Available Releases

Browse release notes by version (newest first):

  • v2.0.0 - Latest release with multi-tenant Organizations, PostgreSQL Row-Level Security, SSO OIDC/LDAP, and governed Connectors
  • v1.9.3 - Bug-fix release bridging v1.9.2 and v2.0.0
  • v1.9.2 - New input elements, UI enhancements, and architectural improvements
  • v1.9.1 - PDF reporting, application merging, and PostgreSQL 16 support
  • v1.9.0 - Admin roles, JWT configuration, and materialized views
  • v1.8.8 - GeoJSON editor, custom expression editor, and OpenShift deployment
  • v1.8.7 - Workflow enhancements, security improvements, and UI updates
  • v1.8.6 - Query management and PostgreSQL compatibility
  • v1.8.5 - Backend refactor and workflow enhancements
  • v1.8.4 - Query creation fix
  • v1.8.3 - Uninstallation improvements
  • v1.8.2 - Dependency update
  • v1.8.1 - Query group bug fix
  • v1.8.0 - PostgreSQL upgrade, query groups, and trial version
  • v1.7.4 - Query management improvements and repository proxy
  • v1.7.3 - External database installation and hotfixes
  • v1.7.0 - Application extensions, enhanced UI, and database improvements
  • v1.6.0 - Extensions store, enhanced charts, and notifications
  • v1.5.0 - Workflow improvements, notifications, and custom expressions
  • v1.4.1 - App migration, custom CSS, and usability improvements
  • v1.3.0 - Installation on existing database and usability improvements

Image

A image display viewport with support for direct uploads, storage path resolution, custom URL expressions, click-to-expand full size previews, frame borders, and image fitting modes.

When to use

  • Displaying static or dynamic images sourced from internal storage, uploaded files, or external URLs.
  • Presenting visual assets with fit scaling controls (e.g., scale to fit, adjust to width/height, stretch) and full-size click-to-expand preview capabilities.

What you need

  • Image URLs, relative storage paths, file system asset keys, or custom dynamic image expressions.

Examples

  • A profile overview tile rendering a user avatar retrieved dynamically from internal storage paths with click-to-expand preview enabled.
  • An image gallery asset display loading an external HTTPS image path with scale-to-fit formatting and frame borders.

Avoid

  • Squeezing image displays into tiny layout boxes — allocate at least 3 rows high and 6 columns wide for comfortable image viewing.
  • Using as a file upload input element — use the storage_file_input component instead to allow user file selections.

Use instead

Read full post

Release Notes v1.9.1

Features

  • PDF Reporting:

    • Added a new page type for reports, allowing users to generate PDFs directly from the application

    • Introduced Interactive and Static PDF Report Generation with LaTeX support for structured reports.

  • Application Management & Usability:

    • Merge Applications: Admins can now merge multiple applications built for the same user role using the Published Release or the Last Save Point, enhancing team collaboration and feature integration.

Read full post

Button Group

A row of buttons rendered as one connected control, so a set of related actions reads as a single choice rather than scattered buttons.

When to use

  • Two or more actions that belong together and share styling, such as Save / Save and close / Cancel.

Examples

  • The action bar at the foot of a form.
  • A group of filter shortcuts above a table.

Avoid

  • Mixing unrelated actions into one group — the shared framing implies the buttons are alternatives to each other.
  • Putting a single button in a group; place the button directly instead.

Pairs well with

Read full post

Color Input

A clickable colored input block covering its container area that launches a full popout color picker selection window when clicked. If configured, a plain uncolored label is rendered adjacent to the color block.

When to use

  • Allowing users to pick a color visually using an advanced popup color picker panel.
  • Binding user-selected colors as hex string data values within database records.

What you need

Deactivated by default. Requires an active connection to a parent default_form element via Element ID and Field Path attributes.

Read full post