docyrus-platform

Docyrus Platform

Docyrus is an AI-native Backend Platform as a Service (BPaaS) for building B2B web/mobile apps, client portals, internal tools, AI agents, chatbots, and integrations — without building backend infrastructure from scratch. This skill is the architecture map: the building blocks, how they fit, and which dedicated skill owns each how-to.

Core Building Blocks

The platform is composed of building blocks that compose into apps:

• Apps — Top-level containers that group data sources, automations, agents, and custom queries into a deployable unit.
• Data Sources — Structured collections of records with typed schemas. Four types: simple, advanced, external (connected DBs/APIs), and system (pre-built). Every data source — internal or external — is exposed through one unified CRUD endpoint.
• Fields — 45+ field types defining each data source's schema: text, numbers, dates, selections, relations, files, formulas, nested data, and more.
• Enumerations — Reusable option sets for selection fields (color, icon, ordering).
• Custom Queries — SQL-based analytics templates with variable interpolation, runtime filters, and multi-database targeting.
• Automations — Event-driven workflows: triggers (record changes, schedule, webhook, email, webform, button) → action-node chains (email, notifications, record ops, HTTP, AI, scripts).

Detailed building-block specifications: references/core-building-blocks.md.

Which skill for which task

This skill holds the concepts. For doing the work, use the dedicated skill:

To…	Use skill
Design a data source (schema, fields, relations, enums, access)	docyrus-data-source-design
Build an automation (triggers + action-node graph)	docyrus-automation-design
Build a custom AI agent + its sub-resources	docyrus-agent-design
Author AI tools the system base agent ("Docy") calls	docyrus-app-ai-tools
Design an email template	docyrus-email-template-design
Design an HTML/PDF print/report template	docyrus-print-pdf-template-design
Build a public webform that collects submissions into records	docyrus-webform-design
Design a data source's record create/edit/view form (grid, sections, conditional rules)	docyrus-dynamic-form-design
Configure tenant ACL (roles, hierarchy units, role rules)	docyrus-acl-design
Discover & call third-party integrations/connectors (docyrus connect)	docyrus-integrations-and-connectors
Query/CRUD data, write filters/formulas, build query payloads	docyrus-api-dev
Write DSQL (logical SQL) queries, or natural-language dsql ask	docyrus-dsql-query-design
Drive everything from the terminal (auth, ds, studio, automation, agent, …)	docyrus-cli-app
Build a React app on Docyrus (collections, grids, forms)	docyrus-app-dev-react, docyrus-data-grid-page-design, docyrus-record-detail-form-design

Capability areas (concepts)

Querying & Data Operations

Unified query engine: column selection, 50+ filter operators, aggregations, formulas, pivots, child queries, full-text search; full CRUD with bulk ops, comments, and attachments; plus a read-only logical SQL endpoint (DSQL) over appSlug.dataSourceSlug tables. Concept overview: references/querying-and-data-operations.md. → Query payloads & formulas: docyrus-api-dev. DSQL (logical SQL, dsql ask): docyrus-dsql-query-design. Terminal querying: docyrus-cli-app.

AI Capabilities

AI agent builder with tool binding, knowledge bases, MCP servers, 18+ model providers, agent chaining, task scheduling, persistent memory, chat integrations, and evaluation metrics. Concept overview: references/ai-capabilities.md. → Build agents: docyrus-agent-design. Author the tools Docy calls: docyrus-app-ai-tools.

Automation & Workflows

Event-driven automation engine: trigger types and action-node types, conditional flows, action chains, archiving. Concept overview: references/automation-and-workflows.md. → Build automations: docyrus-automation-design.

Authentication & Multi-Tenancy

OAuth2 flows (PKCE, Client Credentials, Device Code), scope-based permissions, tenant isolation, role-based and record-level ACL, React auth helpers, and the client portal. Concept overview: references/auth-and-multi-tenancy.md. → Configure ACL: docyrus-acl-design. OAuth in app code: docyrus-api-dev.

Integrations & Events

Connector framework for HTTP and SQL providers, webhook/event management, connector discovery, collaborative document editing, in-app messaging, notifications, and email. Concept overview: references/integrations-and-events.md. → Discover & use connectors (docyrus connect): docyrus-integrations-and-connectors. Webhook/messaging CLI: docyrus-cli-app.

Platform Services

App templates, data import/export, reporting & analytics, deployment & versioning, localization & navigation, audit logging, and billing. Concept overview: references/platform-services.md. → Public data-collection webforms are their own skill: docyrus-webform-design.

Developer Tools

Auto-generated OpenAPI specs, MCP server, a full-featured CLI, REST API client libraries, a React auth provider, and auto-generated collection hooks. Concept overview: references/developer-tools.md. → Full CLI command index: docyrus-cli-app (docyrus <cmd> --help for flags). REST client + query payloads + formulas: docyrus-api-dev.