Skip to content

Beta.24 docs#158

Merged
Adammatthiesen merged 4 commits into
mainfrom
beta.24
Aug 11, 2025
Merged

Beta.24 docs#158
Adammatthiesen merged 4 commits into
mainfrom
beta.24

Conversation

@Adammatthiesen
Copy link
Copy Markdown
Member

@Adammatthiesen Adammatthiesen commented Aug 11, 2025

TODO before merge

  • Update package.json references to actual versions, and submodule

Changes

  • Removed "Updated" badges from various documentation pages including features, upgrade guides, how it works, plugins, and getting started.
  • Added new constants PLUGINS and MIDDLEWARES to the SDKCoreJs import in the SDK documentation.
  • Changed the badge text and variant for the WYSIWYG plugin from "Experimental" to "Plugin" with a "tip" variant.
  • Updated subproject reference in the studiocms directory.
  • Added new upgrade guide for version 0.1.0-beta.24, detailing breaking changes and bug fixes.

Summary by CodeRabbit

  • Documentation

    • Added upgrade guide for 0.1.0-beta.24 with breaking changes and fixes.
    • Updated SDK examples to include PLUGINS and MIDDLEWARES.
    • Removed or updated badge metadata across multiple docs pages for consistency.
    • Updated WYSIWYG plugin badge from “Experimental” to “Plugin”.
  • Chores

    • Migrated StudioCMS packages to private-registry equivalents and updated submodule revision.
    • Upgraded core tooling and added several build/docs dependencies (tooling and TypeScript upgrades).

- Removed "Updated" badges from various documentation pages including features, upgrade guides, how it works, plugins, and getting started.
- Added new constants `PLUGINS` and `MIDDLEWARES` to the SDKCoreJs import in the SDK documentation.
- Changed the badge text and variant for the WYSIWYG plugin from "Experimental" to "Plugin" with a "tip" variant.
- Updated subproject reference in the studiocms directory.
- Added new upgrade guide for version 0.1.0-beta.24, detailing breaking changes and bug fixes.
@netlify
Copy link
Copy Markdown

netlify Bot commented Aug 11, 2025

Deploy Preview for studiocms-dev-docs ready!

Name Link
🔨 Latest commit 84c5534
🔍 Latest deploy log https://app.netlify.com/projects/studiocms-dev-docs/deploys/689a057321ffc90008ca7c41
😎 Deploy Preview https://deploy-preview-158--studiocms-dev-docs.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@coderabbitai
Copy link
Copy Markdown
Contributor

coderabbitai Bot commented Aug 11, 2025

Walkthrough

Migrates Studiocms packages to private-registry pins (commit 853e6e6), updates/bumps various dependencies and tooling, adds a new 0.1.0-beta.24 upgrade guide, removes several docs sidebar badges, updates an SDK example to show PLUGINS and MIDDLEWARES, tweaks a plugin badge, and advances the studiocms submodule.

Changes

Cohort / File(s) Change Summary
Dependency & tooling updates
package.json
Replace public beta @studiocms packages with private-registry URLs pinned to commit 853e6e6; bump versions (e.g., @studiocms/web-vitals, astro, @astrojs/db); add many tooling/docs dependencies (TypeScript, biome, knip, tsm, lunaria from private registry, starlight/typedoc/rehype/hast tooling, etc.).
Submodule update
studiocms
Advance submodule pointer from 58c0b22 to 853e6e6.
Docs: remove sidebar badges
src/content/docs/en/config-reference/features.mdx, src/content/docs/en/how-it-works/index.mdx, src/content/docs/en/plugins/index.mdx, src/content/docs/en/start-here/getting-started.mdx, src/content/docs/en/utils/rendering.mdx, src/content/docs/en/guides/upgrade/version-guides/0-1-0-beta-23.mdx
Remove sidebar.badge frontmatter blocks; no content changes.
Docs: new upgrade guide
src/content/docs/en/guides/upgrade/version-guides/0-1-0-beta-24.mdx
Add upgrade guide with frontmatter, QuickUpdate component, Breaking Changes (StudioCMSPluginData table, SDK plugin typing utilities), migration note (astro db push --remote), and bug fixes list.
Docs: SDK API snippet
src/content/docs/en/how-it-works/sdk.mdx
Update example destructuring to include PLUGINS and MIDDLEWARES alongside existing GET, POST, UPDATE (documentation-only).
Docs: plugin badge tweak
src/content/docs/en/package-catalog/studiocms-plugins/studiocms-wysiwyg.mdx
Change sidebar.badge from Experimental/danger to Plugin/tip.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~8 minutes

Possibly related PRs

  • Beta.22 docs #150 — Alters package.json studiocms dependencies and updates submodule pointers (strong overlap with dependency/submodule changes).
  • beta 18 docs #133 — Similar dependency realignments and submodule update; overlaps in docs frontmatter edits.
  • add beta.20 guide #142 — Modifies upgrade/version-guides and related docs changes similar to this PR.

Suggested labels

i18n

Suggested reviewers

  • louisescher
  • dreyfus92

Poem

I nibble lines of package trees and hop—
Badges fall away, new guides bloom on top.
Private burrows hold the pinned commit tight,
PLUGINS and MIDDLEWARES peek into light.
A tiny submodule dance, then off I trot. 🐇✨


📜 Recent review details

Configuration used: CodeRabbit UI
Review profile: CHILL
Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between 44eccad and 45da0c9.

📒 Files selected for processing (1)
  • src/content/docs/en/guides/upgrade/version-guides/0-1-0-beta-24.mdx (1 hunks)
✅ Files skipped from review due to trivial changes (1)
  • src/content/docs/en/guides/upgrade/version-guides/0-1-0-beta-24.mdx
✨ Finishing Touches
🧪 Generate unit tests
  • Create PR with unit tests
  • Post copyable unit tests in a comment
  • Commit unit tests in branch beta.24

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
🪧 Tips

Chat

There are 3 ways to chat with CodeRabbit:

  • Review comments: Directly reply to a review comment made by CodeRabbit. Example:
    • I pushed a fix in commit <commit_id>, please review it.
    • Explain this complex logic.
    • Open a follow-up GitHub issue for this discussion.
  • Files and specific lines of code (under the "Files changed" tab): Tag @coderabbitai in a new review comment at the desired location with your query. Examples:
    • @coderabbitai explain this code block.
  • PR comments: Tag @coderabbitai in a new PR comment to ask questions about the PR branch. For the best results, please provide a very specific query, as very limited context is provided in this mode. Examples:
    • @coderabbitai gather interesting stats about this repository and render them as a table. Additionally, render a pie chart showing the language distribution in the codebase.
    • @coderabbitai read src/utils.ts and explain its main purpose.
    • @coderabbitai read the files in the src/scheduler package and generate a class diagram using mermaid and a README in the markdown format.

Support

Need help? Create a ticket on our support page for assistance with any issues or questions.

CodeRabbit Commands (Invoked using PR comments)

  • @coderabbitai pause to pause the reviews on a PR.
  • @coderabbitai resume to resume the paused reviews.
  • @coderabbitai review to trigger an incremental review. This is useful when automatic reviews are disabled for the repository.
  • @coderabbitai full review to do a full review from scratch and review all the files again.
  • @coderabbitai summary to regenerate the summary of the PR.
  • @coderabbitai generate docstrings to generate docstrings for this PR.
  • @coderabbitai generate sequence diagram to generate a sequence diagram of the changes in this PR.
  • @coderabbitai generate unit tests to generate unit tests for this PR.
  • @coderabbitai resolve resolve all the CodeRabbit review comments.
  • @coderabbitai configuration to show the current CodeRabbit configuration for the repository.
  • @coderabbitai help to get help.

Other keywords and placeholders

  • Add @coderabbitai ignore anywhere in the PR description to prevent this PR from being reviewed.
  • Add @coderabbitai summary to generate the high-level summary at a specific location in the PR description.
  • Add @coderabbitai anywhere in the PR title to generate the title automatically.

CodeRabbit Configuration File (.coderabbit.yaml)

  • You can programmatically configure CodeRabbit by adding a .coderabbit.yaml file to the root of your repository.
  • Please see the configuration documentation for more information.
  • If your editor has YAML language server enabled, you can add the path at the top of this file to enable auto-completion and validation: # yaml-language-server: $schema=https://coderabbit.ai/integrations/schema.v2.json

Documentation and Community

  • Visit our Documentation for detailed information on how to use CodeRabbit.
  • Join our Discord Community to get help, request features, and share feedback.
  • Follow us on X/Twitter for updates and announcements.

@studiocms-no-reply
Copy link
Copy Markdown
Member

studiocms-no-reply commented Aug 11, 2025

Lunaria Status Overview

🌕 This pull request will trigger status changes.

Learn more

By default, every PR changing files present in the Lunaria configuration's files property will be considered and trigger status changes accordingly.

You can change this by adding one of the keywords present in the ignoreKeywords property in your Lunaria configuration file in the PR's title (ignoring all files) or by including a tracker directive in the merged commit's description.

Tracked Files

File Note
en/config-reference/features.mdx Source changed, localizations will be marked as outdated.
en/guides/upgrade/version-guides/0-1-0-beta-23.mdx Source changed, localizations will be marked as outdated.
en/guides/upgrade/version-guides/0-1-0-beta-24.mdx Localization added, will be marked as complete.
en/how-it-works/index.mdx Source changed, localizations will be marked as outdated.
en/how-it-works/sdk.mdx Source changed, localizations will be marked as outdated.
en/package-catalog/studiocms-plugins/studiocms-wysiwyg.mdx Source changed, localizations will be marked as outdated.
en/plugins/index.mdx Source changed, localizations will be marked as outdated.
en/start-here/getting-started.mdx Source changed, localizations will be marked as outdated.
en/utils/rendering.mdx Source changed, localizations will be marked as outdated.
Warnings reference
Icon Description
🔄️ The source for this localization has been updated since the creation of this pull request, make sure all changes in the source have been applied.

@Adammatthiesen Adammatthiesen marked this pull request as ready for review August 11, 2025 07:19
@Adammatthiesen Adammatthiesen requested a review from a team as a code owner August 11, 2025 07:19
Copy link
Copy Markdown
Contributor

@coderabbitai coderabbitai Bot left a comment

Choose a reason for hiding this comment

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

Actionable comments posted: 0

🧹 Nitpick comments (9)
src/content/docs/en/package-catalog/studiocms-plugins/studiocms-wysiwyg.mdx (1)

8-10: Minor frontmatter tidy-up: remove stray space after key

There’s a trailing space after "badge:" which is inconsistent with surrounding keys.

-  badge: 
+  badge:
     text: 'Plugin'
     variant: 'tip'
src/content/docs/en/how-it-works/sdk.mdx (2)

63-65: Confirm availability of new exports in the published SDK

Docs now show PLUGINS and MIDDLEWARES on SDKCoreJs. Please verify these exports exist in the 853e6e6 build across all registries; otherwise examples will fail at build time.

Would you like me to add a short usage example for PLUGINS and MIDDLEWARES to make this section more actionable?


63-65: Optional: Add a quick usage snippet to anchor the new concepts

A terse example helps readers understand when to reach for these APIs.

Example snippet to add below the destructuring:

// Register or inspect plugins
const allPlugins = SDKCoreJs.PLUGINS.list();

// Compose/request via middleware hooks
const securedGetPages = SDKCoreJs.MIDDLEWARES.apply('auth', SDKCoreJs.GET.pages);
const result = await runSDK(securedGetPages());
src/content/docs/en/guides/upgrade/version-guides/0-1-0-beta-24.mdx (5)

21-21: Tighten phrasing for the breaking change bullet

Current sentence repeats “as well”. Suggest clearer wording.

-- Adds new `StudioCMSPluginData` table to AstroDB for usage by StudioCMS plugins. As well as new SDK plugins utilities for dynamic table typing as well.
+- Adds a new `StudioCMSPluginData` table to Astro DB for StudioCMS plugins. It also introduces new SDK plugin utilities for dynamic table typing.

23-25: Make the migration step explicit and easier to copy

Recommend a code block and minor grammar improvements.

-When updating you will be required to run `astro db push --remote` with your package manager to update your table schema so that the table schema is updated before running the new version!
+Before upgrading, run the following to update your remote table schema:
+
+```bash
+pnpm astro db push --remote
+# or: npm run astro db push -- --remote
+# or: bunx astro db push --remote
+```

31-31: Capitalize SDK and tighten wording

-- Introduce new middlewares sdk module to ensure cache objects are initialized and not empty.
+- Introduces a new Middleware SDK module to ensure cache objects are initialized and non-empty.

32-32: Name/style corrections: robots.txt and Zod

-- Converts internal `robotstxt` to proper zod schema and cleans up related code.
+- Converts internal `robots.txt` handling to a proper Zod schema and cleans up related code.

33-33: Grammar fix

-- Updates editor page, to also inject a id variable for the current page.
+- Updates the editor page to inject an id variable for the current page.
package.json (1)

88-91: Lock Vite override exactly to reduce churn

Using a caret on an override can introduce surprise minor bumps. Suggest pinning to an exact version unless there’s a specific need for the range.

   "pnpm": {
     "overrides": {
-      "vite": "^6.3.4"
+      "vite": "6.3.4"
     }
   }
📜 Review details

Configuration used: CodeRabbit UI
Review profile: CHILL
Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between ecd4eca and 44eccad.

⛔ Files ignored due to path filters (1)
  • pnpm-lock.yaml is excluded by !**/pnpm-lock.yaml
📒 Files selected for processing (11)
  • package.json (1 hunks)
  • src/content/docs/en/config-reference/features.mdx (0 hunks)
  • src/content/docs/en/guides/upgrade/version-guides/0-1-0-beta-23.mdx (0 hunks)
  • src/content/docs/en/guides/upgrade/version-guides/0-1-0-beta-24.mdx (1 hunks)
  • src/content/docs/en/how-it-works/index.mdx (0 hunks)
  • src/content/docs/en/how-it-works/sdk.mdx (1 hunks)
  • src/content/docs/en/package-catalog/studiocms-plugins/studiocms-wysiwyg.mdx (1 hunks)
  • src/content/docs/en/plugins/index.mdx (0 hunks)
  • src/content/docs/en/start-here/getting-started.mdx (0 hunks)
  • src/content/docs/en/utils/rendering.mdx (0 hunks)
  • studiocms (1 hunks)
💤 Files with no reviewable changes (6)
  • src/content/docs/en/how-it-works/index.mdx
  • src/content/docs/en/utils/rendering.mdx
  • src/content/docs/en/config-reference/features.mdx
  • src/content/docs/en/start-here/getting-started.mdx
  • src/content/docs/en/plugins/index.mdx
  • src/content/docs/en/guides/upgrade/version-guides/0-1-0-beta-23.mdx
🔇 Additional comments (6)
studiocms (2)

1-1: LGTM: submodule advanced to 853e6e6 for beta.24 alignment

Pointer update looks good and matches the PR intent to align the studiocms subproject with beta.24.


1-1: Submodule pointer consistency verified

All references to the studiocms submodule—gitlink (mode 160000, commit 853e6e668b46eaa2808e7fcdf4ff4039de3a596d), .gitmodules URL, package.json entries, and pnpm-lock.yaml resolutions—consistently use commit 853e6e6. No updates are needed.

src/content/docs/en/package-catalog/studiocms-plugins/studiocms-wysiwyg.mdx (1)

9-10: Badge update looks correct

Changing the badge to Plugin/tip aligns with the stated PR objective and taxonomy.

package.json (3)

25-33: Private registry URLs look consistent; confirm CI auth & intentional hashes

  • All @studiocms/* dependencies are pinned to the same commit (853e6e6), so there’s no API-drift risk among them.
  • There is also a @lunariajs/core entry at commit 4c8b9b0 – please verify that pin is intentional.
  • Ensure your CI (and any local .npmrc) is configured to authenticate against pkg.pr.new so installs won’t fail.

No code changes needed if auth is in place and the extra pin is deliberate.


44-45: Versions confirmed on npm

Both specified dependency versions are published and available:

  • typescript ^5.8.3 exists (latest stable is 5.9.2)
  • astro-integration-kit ^0.18.0 is the current release

No further action needed.


37-41: Compatibility matrix check ✅
I’ve reviewed the npm metadata for the bumped packages:

  • @astrojs/starlight@0.35.2
  • @astrojs/node@9.3.1
  • @astrojs/react@4.3.0

None of these declare any peerDependencies or engines constraints, so upgrading to Astro ^5.12.9 and @astrojs/db ^0.17.1 does not introduce hidden version requirements.

• If you have a custom Vite override in your astro.config.*, please ensure it remains compatible with the Vite version bundled in Astro 5.

Comment thread src/content/docs/en/guides/upgrade/version-guides/0-1-0-beta-24.mdx Outdated
Comment thread src/content/docs/en/guides/upgrade/version-guides/0-1-0-beta-24.mdx Outdated
Comment thread src/content/docs/en/guides/upgrade/version-guides/0-1-0-beta-24.mdx Outdated
Comment thread src/content/docs/en/guides/upgrade/version-guides/0-1-0-beta-24.mdx Outdated
Comment thread src/content/docs/en/guides/upgrade/version-guides/0-1-0-beta-24.mdx Outdated
Comment thread src/content/docs/en/guides/upgrade/version-guides/0-1-0-beta-24.mdx Outdated
Comment thread src/content/docs/en/guides/upgrade/version-guides/0-1-0-beta-24.mdx Outdated
Co-authored-by: Louis Escher <66965600+louisescher@users.noreply.github.com>
@Adammatthiesen Adammatthiesen merged commit c62815a into main Aug 11, 2025
11 checks passed
@Adammatthiesen Adammatthiesen deleted the beta.24 branch August 11, 2025 15:07
ArmandPhilippot added a commit to ArmandPhilippot/studiocms-docs that referenced this pull request Aug 16, 2025
dreyfus92 pushed a commit that referenced this pull request Aug 17, 2025
This was referenced Aug 25, 2025
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.

4 participants