Skip to content

docs: refresh published package READMEs after protectjs → stack rename#553

Merged
coderdan merged 3 commits into
mainfrom
docs/refresh-package-readmes
Jul 4, 2026
Merged

docs: refresh published package READMEs after protectjs → stack rename#553
coderdan merged 3 commits into
mainfrom
docs/refresh-package-readmes

Conversation

@coderdan

@coderdan coderdan commented Jul 4, 2026

Copy link
Copy Markdown
Contributor

Summary

Follow-up to #552 covering the READMEs that ship to npm. These still carried pre-rename content:

  • All packages — repository, license, and star-badge URLs pointed at cipherstash/protectjs; now cipherstash/stack.
  • @cipherstash/protect — 14 links pointed at the in-repo docs/ tree removed in def9f4b (broken both on GitHub and npm). Each is remapped to the equivalent cipherstash.com/docs page; the architecture diagram is pinned to a permalink of the last commit containing the image. Added a tip directing new projects to @cipherstash/stack.
  • @cipherstash/nextjs — README was flat-out wrong ("This is the main package for the CipherStash Protect JavaScript Package"). Rewritten to describe what the package actually is, with the bundling caveat.
  • @cipherstash/schema, @cipherstash/drizzle, @cipherstash/protect-dynamodb — retitled away from Protect.js branding, with tips pointing at the @cipherstash/stack equivalents. The legacy csTable/protect() API docs are left intact since those packages still export that API.

Includes a patch changeset for the seven affected published packages so the corrected READMEs actually reach npm.

Notes

Summary by CodeRabbit

  • Documentation
    • Refreshed READMEs across CipherStash packages to reflect current branding, repository renames, and corrected license/repository links.
    • Replaced the Next.js README with updated guidance, including integration pointers and a bundling note.
    • Updated Protect, Drizzle, Schema, and DynamoDB READMEs to link to the correct CipherStash docs and clarify that new projects should use @cipherstash/stack (legacy @cipherstash/protect is still documented).
    • Refreshed the CLI README’s MIT badge link.
  • Chores
    • Applied patch-level version bumps to ship the README updates.

- All READMEs: repository/license/star-badge URLs now point at
  cipherstash/stack
- protect: replace 14 dead in-repo docs links with cipherstash.com/docs
  URLs (the docs/ tree was removed in def9f4b); pin the architecture
  diagram to a permalink of the last commit that contained it; add a
  tip pointing new projects at @cipherstash/stack
- nextjs: rewrite README — it described the package as
  '@cipherstash/protect ... the main package'
- schema, drizzle, protect-dynamodb: retitle away from Protect.js
  branding and add tips pointing at the @cipherstash/stack equivalents
  (encryptedTable/encryptedColumn, stack/drizzle, encryptedDynamoDB)
- changeset: patch bumps so the corrected READMEs ship to npm
@coderdan coderdan requested a review from a team as a code owner July 4, 2026 06:38
@changeset-bot

changeset-bot Bot commented Jul 4, 2026

Copy link
Copy Markdown

🦋 Changeset detected

Latest commit: d140575

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 12 packages
Name Type
@cipherstash/stack Patch
stash Patch
@cipherstash/protect Patch
@cipherstash/schema Patch
@cipherstash/drizzle Patch
@cipherstash/nextjs Patch
@cipherstash/protect-dynamodb Patch
@cipherstash/bench Patch
@cipherstash/prisma-next Patch
@cipherstash/basic-example Patch
@cipherstash/prisma-next-example Patch
@cipherstash/e2e Patch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

@coderabbitai

coderabbitai Bot commented Jul 4, 2026

Copy link
Copy Markdown

Review Change Stack

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: a43cdee1-3e66-477f-af38-4162a75143d8

📥 Commits

Reviewing files that changed from the base of the PR and between f29966d and d140575.

📒 Files selected for processing (1)
  • packages/protect-dynamodb/README.md
✅ Files skipped from review due to trivial changes (1)
  • packages/protect-dynamodb/README.md

📝 Walkthrough

Walkthrough

This PR refreshes package READMEs and a changeset after the protectjs → stack repository rename. It updates license links, package introductions, documentation URLs, and README guidance to point new projects toward @cipherstash/stack.

Changes

README Documentation Refresh

Layer / File(s) Summary
Changeset for patch bumps
.changeset/refresh-package-readmes.md
Adds patch version bumps for the affected packages and describes the README link refresh.
License link and intro updates
packages/cli/README.md, packages/drizzle/README.md, packages/nextjs/README.md, packages/protect-dynamodb/README.md, packages/schema/README.md, packages/stack/README.md
Updates license badge URLs and introductory copy to reference the stack repository and the newer @cipherstash/stack package family.
protect package README link overhaul
packages/protect/README.md
Refreshes badges, callouts, architecture image links, issue links, and multiple doc references throughout the README to use current stack URLs and guidance.
Suggested reviewers: tobyhede, auxesis

Estimated code review effort: 1 (Trivial) | ~5 minutes

Possibly related issues

  • cipherstash/stack#554 — Matches the post-rename README and documentation refresh effort across the package READMEs.

Suggested reviewers: tobyhede, auxesis

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title clearly summarizes the main change: refreshing published READMEs after the protectjs to stack rename.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch docs/refresh-package-readmes

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@packages/protect-dynamodb/README.md`:
- Line 10: The license badge in the README is pointing to the wrong package
name, so update the badge target to use `@cipherstash/protect-dynamodb` instead of
`@cipherstash/protect`. Make this change in the badge markup near the license
badge so the rendered metadata matches the documented package.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 9c80f51f-47f0-4d2f-ad8a-5641606ab453

📥 Commits

Reviewing files that changed from the base of the PR and between 7535a18 and aa9c4b1.

📒 Files selected for processing (8)
  • .changeset/refresh-package-readmes.md
  • packages/cli/README.md
  • packages/drizzle/README.md
  • packages/nextjs/README.md
  • packages/protect-dynamodb/README.md
  • packages/protect/README.md
  • packages/schema/README.md
  • packages/stack/README.md

Comment thread packages/protect-dynamodb/README.md Outdated
@coderdan

coderdan commented Jul 4, 2026

Copy link
Copy Markdown
Contributor Author

Docs/meta change. Low risk.

@coderdan coderdan merged commit b405a54 into main Jul 4, 2026
9 checks passed
@coderdan coderdan deleted the docs/refresh-package-readmes branch July 4, 2026 09:03
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