Skip to content

docs(readme): simplify going further snippet#180

Merged
ozzyfromspace merged 1 commit into
mainfrom
claude/readme-revert-nuxt-snippet
May 8, 2026
Merged

docs(readme): simplify going further snippet#180
ozzyfromspace merged 1 commit into
mainfrom
claude/readme-revert-nuxt-snippet

Conversation

@ozzyfromspace
Copy link
Copy Markdown
Contributor

Summary

0.16.1 on npm shipped with the wrong Nuxt install snippet in the README. PR #178 squash-merged a stray README change from PR #177's branch — the Nuxt subsection was rewritten from modules: ['attaform/nuxt'] to a manual defineNuxtPlugin(... vueApp.use(createAttaform())) snippet. PR #177 was closed unmerged precisely because that pattern is wrong (the Nuxt module is the idiomatic install — it exposes the attaform configKey, threads the SSR payload, registers the Vite plugin, and auto-imports useForm; the manual snippet loses all of that), but the commit was still on the docs-reference branch when it merged.

Verified by inspecting the published tarball:

npm pack attaform@0.16.1
grep -A 6 "Nuxt 3 / 4" package/README.md
# → **Nuxt 3 / 4** — install the Vue plugin via a Nuxt plugin:
#   ```ts
#   // plugins/attaform.ts
#   import { createAttaform } from 'attaform'
#   ...

What changed

README-only revert. Restores the Nuxt section to:

// nuxt.config.ts
export default defineNuxtConfig({
  modules: ['attaform/nuxt'],
})

The expanded docs/api/nuxt.md from #178 stays — it leads with the same module install and was the correct deliverable from that PR. Only the README needed to be backed out.

Followup

This needs a 0.16.2 publish to land on npm — the README in the published tarball is what shows up on the npmjs.com package page. After merge, Publish to NPM and Version Bump workflow with version_type=patch will cut it.

Test plan

  • Diff is README-only (git diff --stat shows 1 file changed, 4 insertions(+), 6 deletions(-))
  • After merge + 0.16.2 publish: npm pack attaform@0.16.2 && grep -A 6 "Nuxt 3 / 4" package/README.md shows modules: ['attaform/nuxt']

🤖 Generated with Claude Code

PR #178 squash-merged into 0.16.1 carried a stray README change from
PR #177's branch — the Nuxt subsection in "Going further" got
rewritten from `modules: ['attaform/nuxt']` to a manual
`defineNuxtPlugin(... vueApp.use(createAttaform()))` snippet. PR
#177 was closed unmerged on the basis that the manual-plugin
pattern is wrong (the Nuxt module is the idiomatic install, exposes
the `attaform` configKey, threads SSR payload, registers the Vite
plugin, and auto-imports useForm — all of which the manual snippet
loses), but that commit was somehow still on the branch when #178
was squash-merged.

End result: 0.16.1 shipped to npm with the wrong README snippet.
The expanded `docs/api/nuxt.md` from #178 is fine and stays;
this is a README-only revert.

Restores the snippet to:

  // nuxt.config.ts
  export default defineNuxtConfig({
    modules: ['attaform/nuxt'],
  })

Needs a 0.16.2 publish to land on npm — the README in the published
tarball is what consumers see on the package page.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@vercel
Copy link
Copy Markdown

vercel Bot commented May 8, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
attaform Building Building Preview, Comment May 8, 2026 10:03pm

@ozzyfromspace ozzyfromspace changed the title docs(readme): revert bad Nuxt-plugin snippet, restore module install docs(readme): simplify going further snippet May 8, 2026
@ozzyfromspace ozzyfromspace merged commit 5e99543 into main May 8, 2026
11 of 12 checks passed
@ozzyfromspace ozzyfromspace deleted the claude/readme-revert-nuxt-snippet branch May 8, 2026 22:04
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