Clodo Framework Guide

What is Clodo Framework?

Clodo Framework is a production-ready, enterprise-grade framework for building applications on Cloudflare Workers. It provides high-level abstractions, developer-friendly APIs, and battle-tested patterns for scaling applications across Cloudflare's global edge network.

Why Choose Clodo?

Core Architecture

Key Components

Router

Powerful routing system with parameter extraction, middleware support, and nested routes

Middleware

Composable middleware system for authentication, logging, CORS, rate limiting, and custom logic

Database

Built-in support for Cloudflare D1, KV, Durable Objects, and external databases

Authentication

JWT, OAuth, and custom authentication providers with session management

Validation

Request/response validation with Zod schemas and automatic error handling

Deployment

One-command deployment with environment management and rollbacks

Getting Started

npm install -g @clodo/cli
# or
yarn global add @clodo/cli

clodo create my-app
cd my-app
npm install

clodo dev

clodo deploy

Building Applications

import { Clodo } from '@clodo/framework';

const app = new Clodo();

app.get('/api/users', async (c) => {
  const users = await c.db.query('SELECT * FROM users');
  return c.json(users);
});

app.post('/api/users', async (c) => {
  const { name, email } = await c.req.json();
  const user = await c.db.insert('users', { name, email });
  return c.json(user, 201);
});

export default app;

import { Clodo, auth } from '@clodo/framework';

const app = new Clodo();

// Protected route
app.get('/api/profile', auth.required(), async (c) => {
  const user = c.get('user');
  return c.json({ profile: user });
});

// Admin only
app.get('/api/admin', auth.hasRole('admin'), async (c) => {
  const stats = await getAdminStats();
  return c.json(stats);
});

export default app;

import { Clodo, Database } from '@clodo/framework';

const app = new Clodo({
  database: new Database({
    d1: 'my-database',
    kv: 'my-cache'
  })
});

app.get('/api/posts/:id', async (c) => {
  const { id } = c.req.param();

  // Try cache first
  let post = await c.db.kv.get(`post:${id}`);
  if (!post) {
    // Fetch from D1
    post = await c.db.d1.query(
      'SELECT * FROM posts WHERE id = ?',
      [id]
    );
    // Cache for 5 minutes
    await c.db.kv.put(`post:${id}`, post, { ttl: 300 });
  }

  return c.json(post);
});

export default app;

Advanced Features

Deployment & Scaling

Environment Management

# Development
clodo deploy --env dev

# Staging
clodo deploy --env staging

# Production
clodo deploy --env prod

# Custom environment
clodo deploy --env custom --config production.toml

Enterprise Features

Migration Guide

Migrating existing applications to Clodo Framework is straightforward. We provide migration tools and guides for popular frameworks.

Further Reading