Cloudflare Developer Documentation

🚀 Getting Started in 5 Minutes

Installation

npm install @tamyla/clodo-framework

Create Your First Service

npx create-clodo-service my-new-service --type data-service

Development Setup

cd my-new-service
npm install
npm run dev

Deploy to Production

npm run deploy

That's it! Your service is now running on Cloudflare Workers with enterprise-grade security, database integration, and automated deployment.

Core Concepts

Service Types

🔒 Security-by-Default Architecture

Clodo Framework implements comprehensive security validation:

• API Token Security: AES-256-CBC encrypted storage with automatic prompting
• Dummy Key Prevention: Blocks deployment of development/test keys to production
• Weak Secret Detection: Validates password strength and entropy
• URL Security: Enforces HTTPS in production, blocks localhost in live environments
• JWT Validation: Ensures proper JWT secret strength and configuration

🗓️ Domain Configuration Management

Centralized configuration system with runtime discovery:

• JSON-based Configuration: Environment-specific settings with validation
• Runtime Discovery: Services automatically discover and configure themselves
• Feature Flags: Declarative feature management with domain-specific overrides
• Multi-tenant Support: Customer isolation and configuration management

⚡ Performance & Caching

Optimized for Cloudflare's edge network:

• Schema Caching: Database schema caching for improved performance
• SQL Query Caching: Intelligent query result caching
• Validation Caching: Security validation result caching
• Global Replication: Edge-optimized data distribution

API Reference

🔧 CLI Commands

npx create-clodo-service  --type   # Create new service
npx @tamyla/clodo-framework --help              # Show all commands

--type data-service      # Database operations
--type auth-service      # Authentication & authorization
--type api-gateway       # API routing & orchestration
--type content-service   # Content management & CMS

📚 Core Classes & Functions

import { FeatureFlagManager } from '@tamyla/clodo-framework';

const featureManager = new FeatureFlagManager();
await featureManager.setDomain(domainConfig);
const isEnabled = featureManager.isEnabled('featureName');

import { initializeService } from '@tamyla/clodo-framework';

export default {
  async fetch(request, env, ctx) {
    const service = initializeService(env);
    // Service automatically discovers domain configuration
  }
};

import { createFeatureGuard } from '@tamyla/clodo-framework';

const guardedHandler = createFeatureGuard('premiumFeature')(
  premiumHandler
);

🔗 Additional Resources

• Complete Documentation on GitHub
• Full API Reference
• Internal Documentation