> ## Documentation Index
> Fetch the complete documentation index at: https://developer.kodexa.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Kodexa Developer Portal

> The Kodexa Developer Portal: documentation, guides, SDKs, and references for building document workflows, modules, and integrations on the Kodexa Platform.

<div className="not-prose mb-8 overflow-hidden rounded-lg border border-slate-200 bg-slate-950 shadow-sm dark:border-slate-800">
  <img className="h-44 w-full object-cover sm:h-56" src="https://mintcdn.com/kodexa/50WM2BcrNwiFq-Jl/images/introduction-banner.png?fit=max&auto=format&n=50WM2BcrNwiFq-Jl&q=85&s=76cb3bd849e27b82b0fa6d08896b1bf6" alt="Document-heavy workflows connected into one Kodexa platform flow" noZoom width="1536" height="512" data-path="images/introduction-banner.png" />
</div>

## Welcome to Kodexa

Kodexa is a platform for running document-heavy business processes where automated work, human review, business knowledge, integrations, and audit history need to stay aligned. It gives teams a shared model for turning unstructured documents into governed workflows that can be configured, reviewed, versioned, and reused.

## Documentation Structure

This developer portal is organized into the following sections, each designed to help you at different stages of your journey with Kodexa:

<CardGroup cols={2}>
  <Card title="Welcome" icon="hand-wave" href="/introduction">
    Start here for an overview of the platform and recent changes
  </Card>

  <Card title="Concepts" icon="lightbulb" href="/concepts/introduction">
    Understand the Activity and Task mental model for document-heavy business workflows
  </Card>

  <Card title="CLI Tools" icon="terminal" href="/guides/kdx-cli/overview">
    Command-line tools for local development, GitOps workflows, and infrastructure management
  </Card>

  <Card title="SDK" icon="cube" href="/sdk/index">
    Python and TypeScript SDKs for working with Kodexa Documents programmatically
  </Card>

  <Card title="Guides" icon="book" href="/guides/introduction">
    In-depth guides for Activity Plans, data definitions, event scripting, service bridges, and review forms
  </Card>

  <Card title="API Reference" icon="code" href="/api-reference/introduction">
    Complete REST API documentation for programmatic access to all platform features
  </Card>
</CardGroup>

## Where to Start

### New to Kodexa?

<Steps>
  <Step title="Learn the Document Model">
    Read [What is a Kodexa Document?](/guides/kodexa-document/index) to understand the KDDB format, content nodes, tags, and how data extraction works. Then explore the [Document Structure Deep Dive](/guides/kodexa-document/structure) for a detailed walkthrough.
  </Step>

  <Step title="Model the Data">
    Learn [Data Definitions](/guides/data-definitions/index) to describe the business objects, fields, types, and relationships you want Kodexa to extract and validate.
  </Step>

  <Step title="Understand Activities and Tasks">
    Use [Concepts](/concepts/introduction) to learn how Activities model automated business process runs and Tasks model the human review work inside those processes.
  </Step>

  <Step title="Design the Review Experience">
    Learn [Data Forms](/guides/data-forms/introduction) to see how extracted data is presented for review, correction, validation, and task completion.
  </Step>

  <Step title="Build Your First Project">
    Start with [Projects](/concepts/projects) and [Project templates](/concepts/project_templates) to bind documents, data definitions, Activity Plans, review forms, and permissions into a working business workflow.
  </Step>
</Steps>

### Building Production Applications?

<CardGroup cols={2}>
  <Card title="GitOps Deployment" icon="github" href="/guides/deployment/gitops-github-actions">
    Automate deployments with GitHub Actions, multi-environment promotion, and PR validation
  </Card>

  <Card title="KDX CLI" icon="terminal" href="/guides/kdx-cli/overview">
    Manage resources, sync metadata, and control your Kodexa infrastructure from the command line
  </Card>

  <Card title="API Integration" icon="code" href="/api-reference/introduction">
    Integrate Kodexa into your applications with our comprehensive REST API
  </Card>

  <Card title="Data Forms" icon="table" href="/guides/data-forms/index">
    Build custom UIs for document review, validation, and data extraction
  </Card>
</CardGroup>

### Working with Specific Features?

<AccordionGroup>
  <Accordion title="Document Processing & Modules" icon="file-invoice">
    * [Documents](/concepts/documents) - Understanding document structure and content
    * [Modules](/concepts/modules) - Training and deploying ML modules
    * [Working with Modules](/concepts/working_with_modules) - Practical module usage
    * [Module Runtimes](/concepts/module_runtimes) - Deployment and scaling
  </Accordion>

  <Accordion title="Storage & Data" icon="database">
    * [Document Stores](/concepts/document_stores) - Persistent document storage
    * [Data Stores](/concepts/data_stores) - Structured data storage
    * [Storage Overview](/concepts/storage) - Platform storage architecture
    * [Data Definitions](/guides/data-definitions/index) - Business data models, validation rules, formulas, and event scripts
  </Accordion>

  <Accordion title="Knowledge & Intelligence" icon="brain">
    * [Knowledge Systems](/concepts/knowledge_system) - Building intelligent rule systems
    * [Formulas](/guides/formulas/index) - Dynamic calculations and transformations
    * [Activity Plans](/guides/activity-plans/index) - Automated process runs with scripts, bridge calls, LLM steps, and human review handoffs
  </Accordion>

  <Accordion title="Infrastructure & Deployment" icon="server">
    * [Deployment Overview](/guides/deployment/index) - GitOps workflows
    * [Resource Operations](/guides/kdx-cli/resource-operations) - Managing platform resources
    * [Metadata Sync](/guides/kdx-cli/sync/overview) - Version control for configurations
  </Accordion>
</AccordionGroup>

## Platform Capabilities

Kodexa's capabilities are organized around the way real work happens: an Activity runs the business process, Tasks bring people into that process, and shared platform resources keep the documents, data, knowledge, integrations, and deployments consistent across projects.

<CardGroup cols={2}>
  <Card title="Activity Orchestration" icon="diagram-project" href="/guides/activity-plans/index">
    Model business processes as reusable Activity Plans with steps for extraction, scripts, Service Bridges, LLM calls, approvals, and Task handoffs.
  </Card>

  <Card title="Human Review Tasks" icon="list-check" href="/concepts/tasks">
    Create review, approval, exception, and correction work when an Activity needs human judgment or accountability.
  </Card>

  <Card title="Data Definitions" icon="sitemap" href="/guides/data-definitions/index">
    Define business objects, attributes, types, relationships, selection options, formulas, validation rules, and event-based scripts.
  </Card>

  <Card title="Data Forms" icon="table" href="/guides/data-forms/introduction">
    Build Task review experiences that bind extracted data, document context, exceptions, validation messages, and completion actions.
  </Card>

  <Card title="Kodexa Document Model" icon="file-lines" href="/guides/kodexa-document/index">
    Work with KDDB documents, content nodes, tags, labels, exceptions, data objects, metadata, and provenance.
  </Card>

  <Card title="Knowledge & Intelligence" icon="brain" href="/concepts/knowledge_system">
    Capture reusable knowledge, feature types, rules, examples, prompts, and AI context that shape extraction and decisions.
  </Card>

  <Card title="Integrations & Service Bridges" icon="plug" href="/guides/scripting/service-bridges">
    Connect Activities and scripts to external systems for lookups, enrichment, validation, notifications, and posting results.
  </Card>

  <Card title="CLI, SDK & API" icon="terminal" href="/guides/kdx-cli/overview">
    Manage resources with the KDX CLI, version-controlled metadata, SDKs, REST APIs, GitOps deployment, and environment promotion.
  </Card>
</CardGroup>

| Capability layer | What it owns                                                                       |
| ---------------- | ---------------------------------------------------------------------------------- |
| Activity         | The automated business process run                                                 |
| Task             | The human work created inside the process                                          |
| Data Definition  | The business data model, validation behavior, and event hooks                      |
| Data Form        | The reviewer experience for task completion                                        |
| Project          | The bound set of documents, definitions, activities, forms, users, and permissions |

## Need Help?

<CardGroup cols={1}>
  <Card title="Contact Us" icon="envelope" href="mailto:support@kodexa.com">
    Get in touch with our team for personalized assistance
  </Card>
</CardGroup>

## What's New?

Check the [Change Log](/change-log/index) to see the latest platform updates, new features, and improvements.