SwallowKitType-Safe Azure Dev Toolkit

Schema-driven full-stack development for Next.js on Azure. End-to-end type safety with shared Zod schemas.

🔄

Zod Schema Sharing

Define your schema once and share it across the frontend, BFF, Azure Functions, and Cosmos DB — no duplication, no drift.

⚡

CRUD Code Generation

Run swallowkit scaffold to automatically generate Azure Functions, Next.js BFF routes, and React UI components from your Zod schema.

🛡️

Full Type Safety

End-to-end TypeScript from the React client to the Cosmos DB document. Types are always inferred from your schema, never written by hand.

🎯

BFF Pattern

Next.js API Routes act as a typed Backend-For-Frontend proxy layer, with automatic Zod validation and Azure Functions resource-name inference.

☁️

Azure Optimised

Minimal-cost reference architecture using Azure Static Web Apps, Azure Functions, and Azure Cosmos DB — with Managed Identity throughout.

🚀

Zero-Config Deployment

Provision Azure resources with Bicep IaC and get auto-generated GitHub Actions or Azure Pipelines CI/CD workflows in one command.

Quick Start

bash

npx swallowkit init my-app
cd my-app

Create your first model

bash

npx swallowkit create-model todo

typescript

// shared/models/todo.ts
import { z } from 'zod';

export const todo = z.object({
  id: z.string(),
  text: z.string().min(1).max(200),
  completed: z.boolean().default(false),
  createdAt: z.string().optional(),
  updatedAt: z.string().optional(),
});

export type Todo = z.infer<typeof todo>;

Generate full CRUD

bash

npx swallowkit scaffold shared/models/todo.ts

This generates Azure Functions, BFF API routes, and React components — all fully typed.

Start the dev server

bash

npx swallowkit dev
# Next.js → http://localhost:3000
# Azure Functions → http://localhost:7071

SwallowKitType-Safe Azure Dev Toolkit

Zod Schema Sharing

CRUD Code Generation

Full Type Safety

BFF Pattern

Azure Optimised

Zero-Config Deployment

Quick Start ​

Create your first model ​

Generate full CRUD ​

Start the dev server ​

Quick Start

Create your first model

Generate full CRUD

Start the dev server