Skip to content

Explanation: The Application Ecosystem

While the cx shell provides powerful, low-level primitives like Blueprints and Flows, the Application Ecosystem provides a higher level of abstraction: complete, packaged solutions. Understanding this ecosystem is key to leveraging the full collaborative power of the Contextually platform.

The Problem: From Tools to Solutions

A blueprint is like a single function in a library. A flow is like a single script. They are powerful tools, but a user still needs to compose them to solve a business problem. This requires significant domain knowledge and setup time.

The Monthly Wyndham Report is a perfect example. To make it work, a user needs: - The MSSQL blueprint - The SendGrid blueprint - The get-monthly-wyndham-transactions.sql query - The build-wyndham-report-artifacts.transformer.yaml script - The wyndham_report_email.html template - The final run-monthly-wyndham-report.flow.yaml orchestrator - The knowledge of how to configure the two required connections.

Asking a new team member to assemble all of this manually is slow and error-prone.

The Solution: Applications as Installable Toolkits

A Contextually Application is a self-contained, versioned "toolkit-in-a-box" that bundles all these assets together. The cx app install command acts as a magic wand, orchestrating the entire setup process in a single step.

This is achieved through a declarative, dependency-first model:

  • No Redundancy: Applications do not bundle their required blueprints. They simply declare them as dependencies in an app.cx.yaml manifest. The cx shell uses its built-in resolver to download and cache these blueprints on-demand, ensuring efficiency and reusability.
  • Guided Setup: The manifest also declares the required_connections. The installer reads this and launches an interactive wizard, guiding the user through creating and configuring every necessary connection.
  • Discoverability: A public registry, hosted in the flowcontextually/applications repository, provides a searchable "App Store" for official and community-vetted solutions, accessible via cx app search.
  • Private Distribution: The system is designed for enterprise use, allowing teams to install internal applications directly from private Git repository URLs.

By elevating the unit of sharing from a single script to a complete, documented, and easily installable solution, the Application Ecosystem transforms the cx shell from a personal productivity tool into a powerful platform for team and community collaboration.