Build internal apps and AI agents on RootCX — the open-source platform with shared PostgreSQL, auto-generated CRUD APIs, OIDC SSO, role-based access control, audit logging, scheduled jobs, message queuing, encrypted secrets, file storage, managed deployment, and pre-built integrations. Get everything you need to ship internal tools to production out of the box.
Building RootCX app frontends with @rootcx/ui components, Tailwind v4 styling, AppShell/Sidebar layout, forms, data tables, dark mode, and the AuthGate entry pattern. Load references/components.md for the full component catalogue.
Querying or mutating RootCX data from React using @rootcx/sdk hooks — useAppCollection, useAppRecord, useIntegration, useCoreCollection, useRuntimeClient. Covers QueryOptions, where operators, cross-app reads, and the flat record shape.
Building a RootCX AI agent — project structure, backend/agent.json config, LangGraph createReactAgent, IPC bridge, tools & RBAC, invoke SSE endpoint. Use when scaffolding or editing an agent app with a LangGraph backend.
Writing a RootCX app backend/ Bun worker — JSON-lines IPC protocol with Core, discover/rpc/job/shutdown messages, caller auth, data access patterns, and the minimal worker template. Load when implementing backend/index.ts or handling RPC methods and jobs.
Writing or editing manifest.json for a RootCX app — defining the data contract, entities, field types, entity links, RBAC permissions, and understanding how Core syncs the schema to PostgreSQL on install/deploy.
Calling the RootCX Core REST API directly — collections CRUD, bulk/query endpoints, integrations bind and actions, async jobs queue. Covers where operators, query syntax, and auth. Use when writing worker code, external scripts, or tests that hit the Core HTTP API.
Strict testing guidelines. Use when writing, reviewing, or refactoring tests. Triggers on test, #[test], #[cfg(test)], mod tests, test coverage, unit test, integration test, spec, describe, it(.