timeplus-app-builder

Package Timeplus apps into .tpapp bundles with manifests and templates.

1|Updated Mar 4, 2026
One-click install
npx skills add https://github.com/timeplus-io/AgentSkills --skill timeplus-app-builder
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: timeplus-app-builder
Source: https://github.com/timeplus-io/AgentSkills/tree/main/timeplus-app-builder
Command: npx skills add https://github.com/timeplus-io/AgentSkills --skill timeplus-app-builder

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill enables end-to-end creation, packaging, and installation of Timeplus apps (.tpapp) by converting SQL resources and dashboards into a single deployable bundle, generating manifests, applying template variables, and debugging install failures.

Core Features & Use Cases

  • Manifest-driven app packaging: bundle DDL resources, dashboards, and config into a .tpapp.
  • Template rendering and variable substitution to customize deployments across tenants and environments.
  • Debugging installs and validating manifests against a Timeplus server API prior to deployment.
  • Easy upgrades: re-run packaging and upgrade existing apps with minimal disruption.

Quick Start

Create a manifest.yaml for your app and place your ddl/ dashboards under a folder, then run the packaging workflow to generate a .tpapp.

Frequently Asked Questions about timeplus-app-builder

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I package a Timeplus app for deployment?

To package a Timeplus app, you need a structured app directory containing ddl/ dashboards and a manifest.yaml, which the skill bundles into a single deployable .tpapp file for installation against a Timeplus server.

What is a .tpapp file and when do I need it?

A .tpapp file is a deployable bundle generated by converting SQL resources, DDL, and dashboards into a single package, needed when you want to deploy or upgrade custom applications across Timeplus server environments.

How do I customize Timeplus app deployments across different environments?

You can customize Timeplus app deployments by applying template rendering and variable substitution during packaging, allowing you to tailor manifests and configurations for different tenants or environments.

Why does my Timeplus app installation fail and how do I debug it?

To debug a failed Timeplus app installation, you can validate your manifest.yaml against the Timeplus server API prior to deployment to identify and troubleshoot installation errors before re-running the packaging workflow.

Do I need python_packages to build a Timeplus app?

Including python_packages is optional, but if your app requires specific dependencies, adding them in the manifest allows the packaging workflow to install them automatically before generating the .tpapp bundle.

Can I upgrade an existing Timeplus app without disrupting the server?

Yes, you can upgrade existing Timeplus apps by re-running the packaging workflow to generate a new .tpapp and deploying it, which applies updates with minimal disruption to the Timeplus server.