[Feature] TDK CLI integration: run a TanStack app as a local TDK resource
Maintainer thường phản hồi trong vòng 1 ngày
Chưa có ai nhận issue này.
Đánh giá
- Độ khó
- 5/5
- Thời gian dự kiến
- Hơn một tuần
- Mức phù hợp với người mới
- 35/100
- Loại issue
- Tính năng
- Độ rõ ràng
- Khá rõ ràng
- Mức độ hoạt động
- Sôi nổi
- Công nghệ
- typescript
- Lĩnh vực
- cli, documentation, tooling
Hướng nghiên cứu
Start by tracing the existing TanStack CLI add-on registration, generated app templates, documentation pages, and JSON introspection entry points. Compare the requested Router-only output with the TDK frontend provider contract and linked issue 234; done means the optional add-on, service.json generation, documentation, and introspection behavior satisfy the listed acceptance criteria without changing the default scaffold or treating Start as a provider.
Do mô hình lập chỉ mục viết ra từ nội dung của issue.
Mô tả
Which project does this relate to?
Create Tanstack App
Describe the feature
1. TanStack/cli issue
Project: Create Tanstack App
Labels: enhancement
Describe the feature
Add a documented, optional way to use a TanStack CLI app inside a TDK CLI landscape, and a small add-on that makes that handoff explicit.
TDK CLI (Tilt Development Kit, @tdk-landscape/tdk-cli-core) is a local multi-service runner. It is not a deploy and not a Compose file. Each service has a service.json. tdk up <stack> starts that slice with Docker + Tilt, health-checked boot order, and *.localhost routing. Frontends today are Vite SPAs (react default, vue optional). TDK owns the generated Vite config (.autogenerated/vite.config.frontend.autogenerated.ts) and does not want a root vite.config.ts from the framework provider.
TanStack CLI and TDK CLI solve different problems:
| Tool | Owns |
|---|---|
tanstack create / tanstack add |
App scaffold: Router or Start, add-ons, deployment |
tdk project / tdk resource / tdk up |
Local landscape: ports, stacks, Docker, Tilt, proxy |
There is no shared contract today. A TanStack app dropped into a TDK repo does not get a service.json, and tdk resource --type frontend cannot scaffold TanStack Router or Start.
Requested outcome: one recipe that works from either CLI, with Router-only as the first supported path and Start as an explicit second path.
Proposed use
From an existing TDK project:
tdk project --yes
tdk resource shop-web --type frontend --framework tanstack-router --stack shop --yes
tdk resource orders-api --type backend --stack shop --yes
tdk up shop
From TanStack CLI, opt in with an add-on instead of a new required flag:
tanstack create shop-web --router-only --add-ons tdk -y
# later, inside a TDK project:
tdk up shop
Start stays available, but not by pretending it is the current Vite SPA provider:
# phase 2 — Start dev server is brought in, TDK does not rewrite vite.config.ts
tanstack create shop-web --blank --add-ons tdk -y
tdk resource shop-web --type bring-your-own --stack shop
What the TanStack add-on should write
Category tooling. No runtime dependency on TDK inside the generated app.
service.jsonwithtype: "frontend",framework,stack, and the port convention TDK already uses (frontends in 3000–3999).- A short
TDK.md(or a section in the generated README) with install,tdk up, and the boundary: TDK is local only; deploy stays on the TanStack deployment add-on (Cloudflare, Netlify, and so on). package.jsonscript hints only, for example"dev:tdk": "tdk up"when the CLI is present. Do not failpnpm devif TDK is not installed.- Nothing that overwrites TanStack Start’s
vite.config.tsin v1.
Router-only maps cleanly onto TDK’s provider contract (Vite SPA, no root vite.config.ts, starter index.html + entry). Start does not: Start owns Vite config and is SSR. Shipping Start as a normal --framework provider would fight both generators. Call that out in the issue so it is not implemented as a drive-by.
Acceptance
- Docs page: “Use with TDK CLI”, linked from TanStack CLI docs and from the add-on details (
tanstack create --addon-details tdk). --router-only --add-ons tdkproduces aservice.jsonthattdk config verifyaccepts once the TDK provider exists.--blank/ Start +tdkdocuments the bring-your-own path and does not emit a provider framework id TDK will reject.- Add-on is optional. Default
tanstack createis unchanged. - JSON introspection includes the add-on (
--list-add-ons --json).
Additional context
TDK frontend provider contract: https://github.com/tdk-landscape/tdk-cli-core/blob/main/docs/frontend-framework-providers.md
Relevant TDK commands:
tdk resource my-app --type frontend --stack api
tdk resource my-vue-app --type frontend --framework vue --stack api
framework is an enum on service.json (react, vue today). Unknown ids are rejected before files are written. A TanStack provider has to be registered in TDK (cli/src/frontend-frameworks/, Starlark Vite templates, service-schema.json). That half belongs in tdk-landscape/tdk-cli-core; companion issue linked below.
Companion issue (file against TDK, link here): feat(frontend) tanstack-router provider, and a TanStack Start bring-your-own path.
Non-goals:
- Replacing TanStack deployment add-ons with TDK. TDK does not deploy.
- Making TDK a required toolchain.
- Teaching TDK’s React/Ink CLI UI about TanStack. This is about generated apps and
service.json, not the TDK terminal UI.
Additional context
linked issue https://github.com/tdk-landscape/tdk-cli-core/issues/234
- Ngôn ngữ chính
- TypeScript
- Star
- 1.3k
- Fork
- 188
- Merge trung bình
- 5 giờ 30 phút
- Pull request đã merge (30 ngày)
- 42
Chuẩn bị môi trường
- Không có Dockerfile hay tệp Docker Compose
- Không có mẫu pull request
- Đọc hướng dẫn đóng góp
Bắt đầu từ đâu
- Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
- Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
- Fork repository và làm thay đổi trên một nhánh.
- Mở pull request có tham chiếu số hiệu của issue.
Issue khác của TanStack/cli
-
[Bug] Inconsistent settings in biome.jsonCó thể đã có người làm @tannerlinsley đã nhận 11 ngày trước. Đang mở
Độ khó 1/5 1-3 giờ Mức phù hợp với người mới 76/100
Maintainer thường phản hồi trong vòng 1 ngày
-
Neon add-on depends on deprecated vite-plugin-neon-newCó thể đã có người làm @tannerlinsley đã nhận hôm nay. Đang mở
Độ khó 4/5 3-5 ngày Mức phù hợp với người mới 57/100
Maintainer thường phản hồi trong vòng 1 ngày
-
Proposal: PocketBase add-onCó thể đã có người làm @akanyane đã nhận 13 ngày trước. Đang mở
Độ khó 4/5 3-5 ngày Mức phù hợp với người mới 25/100
TanStack/cli#527 · 2 bình luận · 1 reaction ·
Maintainer thường phản hồi trong vòng 1 ngày
-
tanstack-cli --router-only project tanstack-query add on scaffolds a tanstack-start router.tsxCó thể đã có người làm Có pull request liên kết đang mở hoặc đã được merge. Đang mở
Độ khó 3/5 1-2 ngày Mức phù hợp với người mới 45/100
TanStack/cli#522 · 2 bình luận ·
Maintainer thường phản hồi trong vòng 1 ngày
-
create with bun says Intent is configured but never writes AGENTS.mdCó thể đã có người làm @cfngc4594 đã nhận 63 ngày trước. Đang mở
Độ khó 3/5 1-2 ngày Mức phù hợp với người mới 68/100
TanStack/cli#512 · 1 bình luận ·
Maintainer thường phản hồi trong vòng 1 ngày
Issue tương tự
-
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 78/100
fb55/htmlparser2#2579 ·
Maintainer thường phản hồi trong vòng 1 ngày
-
bug good first issue needs-review
Độ khó 1/5 1-3 giờ Mức phù hợp với người mới 83/100
Maintainer thường phản hồi trong vòng 1 ngày
-
Add Module DB RulesĐang mởdocumentation public
Độ khó 1/5 1-3 giờ Mức phù hợp với người mới 68/100
midnightntwrk/umbradb#65 ·
Maintainer thường phản hồi trong vòng 2 ngày
-
area/channels kind/bug priority/medium
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 78/100
nanocoai/nanoclaw#4501 · 1 bình luận ·
Maintainer thường phản hồi trong vòng 1 ngày
-
Docker images: plain X.Y.Z tag (e.g. 7.2.3) is never updated after the initial release buildĐang mởneeds verification
Độ khó 2/5 1-3 giờ Mức phù hợp với người mới 74/100
Maintainer thường phản hồi trong vòng 13 ngày