creating-an-app

Automate Cloudflare app onboarding in the iterate monorepo with scripts and CI wiring.

198|19|Updated Sep 15, 2025
One-click install
npx skills add https://github.com/iterate/iterate --skill creating-an-app
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: creating-an-app
Source: https://github.com/iterate/iterate/tree/main/.agents/skills/creating-an-app
Command: npx skills add https://github.com/iterate/iterate --skill creating-an-app

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Creating a new Cloudflare app in this monorepo requires consistent package scripts, Doppler wiring, and CI workflow integration, and doing it manually is error-prone.

Core Features & Use Cases

  • Establishes a minimal app contract: Keeps the app action focused on only the required lifecycle commands (for example, alchemy:up, alchemy:down, and test:e2e when live preview tests exist).
  • Wires CI using the shared workflow generator: Ensures Cloudflare deploy workflows are created via .github/ts-workflows/ and the shared app manifest in packages/shared/src/apps/new-style-cloudflare-apps.ts.
  • Connects preview testing and managed previews: Adds preview metadata and ensures previews run through the repo preview router rather than app-local routing.

Quick Start

Tell the team to create the new app under apps/, update the shared app manifest for its slug/path/Doppler project, and add the minimal deploy entry so preview and main deployments are generated from the ts-workflows pipeline.

Frequently Asked Questions about creating-an-app

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I add a new Cloudflare Workers app to a monorepo with CI?▼

To add a new Cloudflare Workers app to a monorepo with CI, you create the app under apps/, update the shared app manifest for its slug and Doppler project, and regenerate the Cloudflare deploy YAML from the ts-workflows system.

What package scripts are required for a new Cloudflare app?▼

The required package scripts for a new Cloudflare app focus on lifecycle commands like `alchemy:up`, `alchemy:down`, and `test:e2e` if live preview tests exist, keeping the app action minimal and focused.

How do preview deployments work with Cloudflare Workers in CI?▼

Preview deployments for Cloudflare Workers run through a shared repo preview router rather than app-local routing, requiring optional preview test metadata and generated CI workflows to participate in PR previews.

Do I need Doppler to manage environment variables for Cloudflare Workers?▼

Yes, Doppler is used for environment variable management, with environment selection kept outside of the app scripts and wired directly through the shared new-style app manifest configuration.

How does the ts-workflows generator create CI workflows for Cloudflare apps?▼

The ts-workflows generator creates CI workflows by reading the shared app manifest in packages/shared/src/apps/new-style-cloudflare-apps.ts and regenerating GitHub Actions YAML to handle both preview and main deployments.

Why keep Doppler environment selection out of Cloudflare app scripts?▼

Keeping Doppler environment selection outside of app scripts enforces a shared deployment contract, preventing manual configuration errors and ensuring consistent environment wiring across the monorepo's CI workflows.