Summary

Request for a small, optional way to use npm create refine-app together with TDK CLI in a local multi-service setup, or, if that is not wanted here, for guidance on where such a note should live.

What TDK is

TDK (Tilt Development Kit, @tdk-landscape/tdk-cli-core) is a local multi-service runner. Every service has a service.json, and tdk up <stack> starts that slice with Docker + Tilt, health-checked boot order and *.localhost routing through Traefik. It is not a deploy tool and not a production Compose replacement. Requirements: Docker, Tilt, Bun (for the services it generates).

Why this might fit

refine can scaffold a Vite React app, and TDK already has a react frontend provider plus a generated API client for sibling backends. The useful part for refine users is the other half: a local landscape with the API and database that the refine data provider talks to.

What I am asking for

• A docs page or example, "Run refine with a local TDK backend", showing a refine Vite app pointed at a TDK-routed API (*.localhost). I will write it and send the PR if you say where examples live.
• No change to create-refine-app is requested.

Example flow:

tdk project --yes
tdk resource orders-api --type backend --stack shop --yes
npm create refine-app@latest shop-admin        # Vite + React
tdk resource shop-admin --type bring-your-own --stack shop
tdk up shop
tdk networks     # lists the *.localhost URLs to use as the data provider base URL

Acceptance

• The example runs from a clean checkout using only the commands shown.
• refine gains no dependency on TDK.
• Optional and additive. TDK is not a required toolchain and does not deploy anything.

Non-goals

• Replacing your deployment guidance. TDK is local-only.
• Making TDK a dependency of refine.

Related

Companion issue on the TDK side (the provider or recipe that this depends on): tdk-landscape/tdk-cli-core#245

Disclosure: I'm one of the TDK maintainers, and I drafted this issue with AI assistance. TDK is a young, small project (1.3.x), so I'm keeping the ask small and optional. If this isn't a fit, or isn't wanted in the issue tracker, please just say so and I'll close it.