Skip to content

docs: remove ntk tailwind, document the real dev loop - #37

Merged
next-devin merged 1 commit into
mainfrom
ntk-tailwind-docs
Jul 23, 2026
Merged

docs: remove ntk tailwind, document the real dev loop#37
next-devin merged 1 commit into
mainfrom
ntk-tailwind-docs

Conversation

@next-devin

Copy link
Copy Markdown
Contributor

Problem

Spark's README and CLAUDE.md document ntk tailwind / ntk tailwind --minify and claim ntk watch auto-compiles Tailwind. Neither is true of released ntk (1.1.1): the tailwind subcommand exists only on an unmerged theme-kit branch, and ntk watch only watches and pushes files (its compile step covers sass/, which Spark does not use). Anyone following the docs hits a hard failure at the first CSS change.

Alex ruled on NextCommerceCo/theme-kit#31 that ntk stays frontend-framework-agnostic, so the fix is to remove the references rather than wait for a release.

What changed

  • Removed the two ntk tailwind rows from the README command table and the CLAUDE.md dev block.
  • Corrected the ntk watch description in both files: it watches and pushes, and the Tailwind compile comes from the standalone binary.
  • Promoted make dev (Tailwind watcher + ntk watch in parallel) from its Legacy label to the standard dev loop, which matches what the Makefile actually does. Added make watch to the README table for the two-terminal setup, and dropped the stale Legacy labels on make css / make build.
  • Added one line to CLAUDE.md recording the decision with a pointer to theme-kit#31.

Verification

  • grep -rn 'ntk tailwind' README.md CLAUDE.md docs/ is clean.
  • python3 -m unittest discover -s tests passes.
  • Command descriptions checked against the Makefile targets and the released ntk parser.

Part of the storefront theme Epic (NextCommerceCo/skills#29). theme-kit#31 can close once this lands; the remaining ntk tailwind references in the Shopify guide are covered by NextCommerceCo/guides#38.

🤖 Generated with Claude Code

Released ntk has no tailwind subcommand and ntk watch does not compile
Tailwind; both claims came from an unmerged theme-kit branch. Per the
decision on NextCommerceCo/theme-kit#31 (ntk stays frontend-framework-
agnostic), remove the ntk tailwind rows, correct the ntk watch
description, and promote make dev from its Legacy label to the standard
loop. Add make watch to the README table for the two-terminal setup.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@next-devin
next-devin marked this pull request as ready for review July 23, 2026 09:18
@kilo-code-bot

kilo-code-bot Bot commented Jul 23, 2026

Copy link
Copy Markdown

Code Review Summary

Status: No Issues Found | Recommendation: Merge

Files Reviewed (2 files)
  • CLAUDE.md
  • README.md

Reviewed by minimax-m3 · Input: 35.7K · Output: 2.3K · Cached: 246.3K

@next-devin
next-devin merged commit 350270e into main Jul 23, 2026
2 checks passed
@next-devin
next-devin deleted the ntk-tailwind-docs branch July 23, 2026 11:39
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant