# Reference

import { CardGrid, LinkCard } from '@astrojs/starlight/components';

Find precise technical information about pgflow's APIs, configuration options, and internal components.

## Security

<CardGrid>
  <LinkCard
    title="Permissions"
    href="/reference/permissions/"
    description="Database permission requirements for client access, Edge Workers, and security configuration"
  />
</CardGrid>

## Configuration

<CardGrid>
  <LinkCard
    title="Overview"
    href="/reference/configuration/"
    description="Learn how pgflow configuration is structured and when to use each option"
  />
  <LinkCard
    title="Step Execution Options"
    href="/reference/configuration/step-execution/"
    description="Configure retry behavior, timeouts, and error handling for flow steps"
  />
  <LinkCard
    title="Worker Configuration"
    href="/reference/configuration/worker/"
    description="Runtime settings for Edge Worker including concurrency and database connections"
  />
</CardGrid>

## APIs

<CardGrid>
  <LinkCard
    title="@pgflow/client API"
    href="/reference/pgflow-client/"
    description="TypeScript client for starting flows and streaming real-time progress"
  />
  <LinkCard
    title="Context API Reference"
    href="/reference/context/"
    description="Complete reference for all properties available in the handler context object"
  />
  <LinkCard
    title="Compile API"
    href="/reference/compile-api/"
    description="Generate SQL statements from Flow definitions programmatically"
  />
  <LinkCard
    title="Manual installation"
    href="/reference/manual-installation/"
    description="Install pgflow without the CLI using manual SQL execution"
  />
</CardGrid>

## Queue Worker

<CardGrid>
  <LinkCard
    title="Configuration"
    href="/reference/queue-worker/configuration/"
    description="Configuration options for using Edge Worker in queue-only mode"
  />
  <LinkCard
    title="How it works"
    href="/reference/queue-worker/how-it-works/"
    description="Internal implementation details of the Edge Worker task queue system"
  />
</CardGrid>