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.