Developer Resources

Build on the Business Operating System

Create deterministic business applications using FSM models, server-driven UI, and the BOS platform architecture. From lead management systems to web-based games — build anything with guaranteed process execution.

Get Started in Minutes

Define your application as an FSM graph with server-driven UI bindings. No configuration required.

🎯

FSM-First Architecture

Define business processes as finite state machines with guaranteed transitions, deterministic execution, and built-in audit trails.

📱

Server-Driven UI

UI components generated dynamically from metadata. No frontend code required — the platform renders your interface automatically.

🔧

Zero Configuration

Applications work instantly. Multi-tenant isolation, authentication, and database schemas handled automatically by the platform.

Simple FSM Node Definition
{
  "node_id": "lead_qualification",
  "type": "action",
  "name": "Qualify Lead",
  "ui_bindings": {
    "component": "Form",
    "fields": [
      {
        "type": "input",
        "label": "Company Size",
        "validation": "required"
      }
    ]
  },
  "transitions": {
    "qualified": "schedule_demo",
    "not_qualified": "nurture_sequence"
  }
}

Core APIs & Endpoints

Everything you need to build, deploy, and manage applications on the BOS platform.

GET
/api/v1/app/{app_name}/state
Retrieve current FSM state and available actions for a user's app instance.
POST
/api/v1/app/{app_name}/execute-action
Execute an FSM transition with validation, state persistence, and UI response generation.
GET
/api/v1/graph/nodes
List all FSM nodes in your application graph with metadata and transition rules.
POST
/api/v1/graph/nodes
Create new FSM nodes with UI bindings, business rules, and transition logic.
GET
/api/v1/analytics/conversion
Analyze conversion funnels, state transition patterns, and process optimization insights.
POST
/api/v1/plugins/execute
Execute custom business logic plugins with platform integration and error handling.

Implementation Examples

Real code examples showing how to build different types of applications on BOS.

Lead Management FSM
// Define a complete lead management process
{
  "graph_id": "lead_management_v1",
  "nodes": {
    "new_lead": {
      "type": "entry",
      "name": "New Lead Captured",
      "auto_transition": "lead_scoring"
    },
    "lead_scoring": {
      "type": "ml_action",
      "name": "AI Lead Scoring",
      "plugin": "ml_lead_scorer",
      "transitions": {
        "hot_lead": "immediate_contact",
        "warm_lead": "schedule_followup",
        "cold_lead": "nurture_sequence"
      }
    },
    "immediate_contact": {
      "type": "human_action",
      "name": "Sales Rep Contact",
      "ui_bindings": {
        "component": "ContactForm",
        "urgency": "high"
      }
    }
  },
  "business_rules": {
    "sla_hot_lead": "contact_within_5_minutes"
  }
}
Server-Driven UI Components
// UI automatically generated from FSM metadata
{
  "ui_bindings": {
    "component": "ConversionOptimizedForm",
    "layout": "mobile_first",
    "fields": [
      {
        "name": "lead_source",
        "type": "select",
        "options_endpoint": "/api/v1/metadata/lead_sources",
        "validation": "required"
      },
      {
        "name": "budget_range",
        "type": "slider",
        "min": 1000,
        "max": 100000,
        "step": 1000
      }
    ],
    "actions": [
      {
        "label": "Qualify Lead",
        "action_id": "submit_qualification",
        "style": "primary"
      }
    ]
  }
}
Custom Business Logic Plugin
# Python plugin for custom scoring logic
from bos_sdk import Plugin, PluginContext

class LeadScoringPlugin(Plugin):
    def execute(self, context: PluginContext):
        lead_data = context.get_node_data()

        # Custom scoring algorithm
        score = 0
        if lead_data.get('company_size') > 100:
            score += 25

        if 'enterprise' in lead_data.get('industry', ''):
            score += 30

        # Platform handles transitions automatically
        if score >= 75:
            return context.transition('hot_lead')
        elif score >= 50:
            return context.transition('warm_lead')
        else:
            return context.transition('cold_lead')
Client Application Integration
// React Native integration example
import { BOSClient } from '@dfsm/bos-sdk';

const LeadCapture = () => {
  const bos = new BOSClient({
    appName: 'lead-director',
    apiKey: process.env.BOS_API_KEY
  });

  const handleSubmit = async (formData) => {
    // Execute FSM transition
    const result = await bos.executeAction({
      action: 'submit_lead',
      data: formData
    });

    // UI automatically updated based on FSM state
    if (result.next_state === 'qualification_complete') {
      navigation.navigate('ThankYou');
    }
  };

  return (
    <BOSForm
      onSubmit={handleSubmit}
      schema={result.ui_schema}
    />
  );
};

What You Can Build

Single-service applications powered by FSM orchestration and server-driven UI.

🎯 Lead Management Systems

End-to-end sales pipelines with AI scoring, automated nurturing, and conversion optimization. Built-in analytics and team collaboration.

Automated lead scoring & routing
Calendar integration & scheduling
Email automation & follow-up

🎮 Web-Based Games

Turn-based strategy games, puzzle games, or educational games with deterministic state management and real-time multiplayer support.

Deterministic game state
Multiplayer coordination
Progress tracking & analytics

💰 SaaS Billing & Subscriptions

Complete subscription management with Stripe integration, usage tracking, and automated billing workflows.

Stripe Connect integration
Usage-based billing
Automated dunning management

📋 Workflow Automation

Custom business workflows with human-in-the-loop approvals, API integrations, and compliance tracking.

Multi-step approval flows
External API integrations
Audit trail & compliance

📊 Analytics Dashboards

Real-time business intelligence with automated insights, custom metrics, and cross-organizational reporting.

Real-time data aggregation
Custom metric definitions
Automated insights & alerts

🏢 Enterprise Resource Planning

Inventory management, procurement workflows, and resource allocation with multi-location support.

Multi-tenant isolation
Role-based permissions
Cross-location reporting

Ready to Build?

Start developing on BOS today. Join the developer beta and get early access to the platform, documentation, and community support.

Join Developer Beta Learn More About BOS