DC-5239 Clerk + Astro Guide #7311
Merged
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Contributor
Dangerous URL checkNo absolute URLs to prisma.io/docs found. |
Contributor
WalkthroughAdds a new Clerk + Astro + Prisma (Postgres) integration guide documenting setup, Clerk configuration (SSR/middleware/UI), Prisma schema and client, webhook handling (verification + upsert), env typing, ngrok/local exposure, Astro server config, testing, troubleshooting, and deployment notes; also updates the site sidebar to include the guide. Changes
Estimated code review effort🎯 2 (Simple) | ⏱️ ~10 minutes
Possibly related PRs
Pre-merge checks✅ Passed checks (3 passed)
Tip 📝 Customizable high-level summaries are now available in beta!You can now customize how CodeRabbit generates the high-level summary in your pull requests — including its content, structure, tone, and formatting.
Example instruction:
Note: This feature is currently in beta for Pro-tier users, and pricing will be announced later. Comment |
Contributor
Redirect checkThis PR probably requires the following redirects to be added to static/_redirects:
|
Contributor
|
Images automagically compressed by Calibre's image-actions ✨ Compression reduced images by 85.4%, saving 314.2 KB.
|
Contributor
Contributor
🍈 Lychee Link Check Report
📊 Results Overview
Errors per inputErrors in 200-orm/200-prisma-client/150-using-raw-sql/200-raw-queries.mdx
Errors in 200-orm/800-more/400-comparisons/03-prisma-and-mongoose.mdx
Errors in 800-guides/420-clerk-astro.mdx
|
Deploying docs with
|
| Latest commit: |
b8b8d47
|
| Status: | ✅ Deploy successful! |
| Preview URL: | https://951d6097.docs-51g.pages.dev |
| Branch Preview URL: | https://dc-5239-astro-clerk-guide.docs-51g.pages.dev |
![coderabbitai[bot]](https://avatars.githubusercontent.com/in/347564?s=60&v=4){kind=small}
Contributor
There was a problem hiding this comment.
Actionable comments posted: 2
🧹 Nitpick comments (1)
content/800-guides/420-clerk-astro.mdx (1)
175-175: Consider removing unusedtsxdependency.The
tsxpackage is installed here but never used in the guide. Unless there's a specific reason for including it that should be documented, consider removing it to keep dependencies minimal.Apply this diff if tsx is not needed:
-npm install prisma tsx @types/pg --save-dev +npm install prisma @types/pg --save-dev
📜 Review details
Configuration used: Path: .coderabbit.yaml
Review profile: CHILL
Plan: Pro
⛔ Files ignored due to path filters (1)
static/img/guides/prisma-clerk-astro-cover.pngis excluded by!**/*.png
📒 Files selected for processing (2)
content/800-guides/420-clerk-astro.mdx(1 hunks)sidebars.ts(1 hunks)
🧰 Additional context used
🪛 LanguageTool
content/800-guides/420-clerk-astro.mdx
[uncategorized] ~57-~57: The official name of this software platform is spelled with a capital “H”.
Context: .... :::info For this guide, the Google, Github, and Email sign in options will be used...
(GITHUB)
🔇 Additional comments (2)
sidebars.ts (1)
394-394: LGTM! Sidebar entry correctly placed.The new guide is properly added to the Integration Solutions category alongside the existing Clerk + Next.js guide, maintaining consistency.
content/800-guides/420-clerk-astro.mdx (1)
1-552: Well-structured and comprehensive guide.This documentation provides clear step-by-step instructions for integrating Clerk authentication with Astro and Prisma Postgres. The troubleshooting section is particularly helpful, and the code examples follow Astro best practices (like using
import.meta.envfor environment variables).
Contributor
🍈 Lychee Link Check Report
📊 Results Overview
Errors per inputErrors in 200-orm/200-prisma-client/150-using-raw-sql/200-raw-queries.mdx
Errors in 200-orm/800-more/400-comparisons/03-prisma-and-mongoose.mdx
Errors in 800-guides/420-clerk-astro.mdx
|
Contributor
🍈 Lychee Link Check Report
📊 Results Overview
Errors per inputErrors in 200-orm/200-prisma-client/150-using-raw-sql/200-raw-queries.mdx
Errors in 200-orm/800-more/400-comparisons/03-prisma-and-mongoose.mdx
Errors in 800-guides/320-permit-io-access-control.mdx
|
Contributor
🍈 Lychee Link Check Report
📊 Results Overview
Errors per inputErrors in 200-orm/200-prisma-client/150-using-raw-sql/200-raw-queries.mdx
Errors in 200-orm/800-more/400-comparisons/03-prisma-and-mongoose.mdx
Errors in 800-guides/420-clerk-astro.mdx
|
Contributor
🍈 Lychee Link Check Report
📊 Results Overview
Errors per inputErrors in 200-orm/200-prisma-client/150-using-raw-sql/200-raw-queries.mdx
Errors in 200-orm/800-more/400-comparisons/03-prisma-and-mongoose.mdx
Errors in 800-guides/320-permit-io-access-control.mdx
|
mhartington
requested changes
Nov 24, 2025
Member
mhartington
left a comment
mhartington
left a comment
There was a problem hiding this comment.
Update the min version of node needed then it's good
Contributor
🍈 Lychee Link Check Report
📊 Results Overview
Errors per inputErrors in 200-orm/050-overview/100-introduction/250-should-you-use-prisma.mdx
Errors in 200-orm/050-overview/500-databases/880-supabase.mdx
Errors in 200-orm/200-prisma-client/150-using-raw-sql/200-raw-queries.mdx
Errors in 200-orm/800-more/400-comparisons/03-prisma-and-mongoose.mdx
|
Contributor
There was a problem hiding this comment.
Actionable comments posted: 0
🧹 Nitpick comments (1)
content/800-guides/420-clerk-astro.mdx (1)
55-55: Correct GitHub capitalization.The official name is "GitHub" with a capital "H" to match official branding.
-For this guide, the Google, Github, and Email sign in options will be used. +For this guide, the Google, GitHub, and Email sign in options will be used.
📜 Review details
Configuration used: Path: .coderabbit.yaml
Review profile: CHILL
Plan: Pro
📒 Files selected for processing (1)
content/800-guides/420-clerk-astro.mdx(1 hunks)
🧰 Additional context used
🧠 Learnings (8)
📚 Learning: 2025-10-03T19:30:57.554Z
Learnt from: aidankmcalister
Repo: prisma/docs PR: 7157
File: content/800-guides/400-deno-integration.mdx:188-190
Timestamp: 2025-10-03T19:30:57.554Z
Learning: For the prisma/docs repository, do not suggest changes to code blocks when reviewing documentation pull requests.
Applied to files:
content/800-guides/420-clerk-astro.mdx
📚 Learning: 2025-11-20T21:00:02.587Z
Learnt from: aidankmcalister
Repo: prisma/docs PR: 7301
File: content/800-guides/410-cloudflare-workers.mdx:87-107
Timestamp: 2025-11-20T21:00:02.587Z
Learning: Do not suggest changes to `prisma.config.ts` files in the prisma/docs repository, as the code examples are intentional for documentation purposes.
Applied to files:
content/800-guides/420-clerk-astro.mdx
📚 Learning: 2025-10-08T16:23:00.388Z
Learnt from: aidankmcalister
Repo: prisma/docs PR: 7165
File: content/800-guides/550-test-guide.mdx:85-90
Timestamp: 2025-10-08T16:23:00.388Z
Learning: For .mdx files in the prisma/docs repository: Only flag code snippets for (1) exposed secrets with real-looking values that should be placeholders (e.g., API keys, database passwords, AWS credentials), or (2) blatant syntax errors like missing parentheses, brackets, braces, or mismatched delimiters. Do not flag code quality issues, anti-patterns, security vulnerabilities, missing error handling, unused variables, or any other bad practices, as documentation intentionally shows problematic code.
Applied to files:
content/800-guides/420-clerk-astro.mdx
📚 Learning: 2025-10-08T16:24:58.382Z
Learnt from: aidankmcalister
Repo: prisma/docs PR: 7165
File: content/800-guides/550-test-guide.mdx:168-176
Timestamp: 2025-10-08T16:24:58.382Z
Learning: For .mdx documentation files specifically, once a suggestion is resolved without implementation, never re-suggest that same change again. Respect the team's judgment that the resolution represents a final decision.
Applied to files:
content/800-guides/420-clerk-astro.mdx
📚 Learning: 2025-10-10T13:13:30.534Z
Learnt from: aidankmcalister
Repo: prisma/docs PR: 7167
File: content/900-ai/prompts/astro.mdx:84-85
Timestamp: 2025-10-10T13:13:30.534Z
Learning: Do not review or comment on files in the `ai/prompts/` directory or matching the path pattern `content/900-ai/prompts/` in the prisma/docs repository.
Applied to files:
content/800-guides/420-clerk-astro.mdx
📚 Learning: 2025-10-08T16:22:57.129Z
Learnt from: aidankmcalister
Repo: prisma/docs PR: 7165
File: content/800-guides/550-test-guide.mdx:50-66
Timestamp: 2025-10-08T16:22:57.129Z
Learning: In `.mdx` files, do NOT flag or suggest changes for the following code quality issues even if they represent poor practices: React anti-patterns (using var instead of useState, direct DOM manipulation), missing keys in .map() iterations, non-serializable props in getServerSideProps, unused variables, missing error handling, SQL injection vulnerabilities (unless actively showing how to fix them), insecure cookie settings, missing TypeScript types, PrismaClient instantiation patterns, or any other code quality, security, or performance issues. Documentation code snippets are copied from source code and often intentionally show "before" examples or common mistakes.
Applied to files:
content/800-guides/420-clerk-astro.mdx
📚 Learning: 2025-10-14T11:41:08.844Z
Learnt from: carlagn
Repo: prisma/docs PR: 7183
File: content/200-orm/800-more/600-help-and-troubleshooting/050-dataguide/050-database-glossary.mdx:561-567
Timestamp: 2025-10-14T11:41:08.844Z
Learning: Ignore the file `content/200-orm/800-more/600-help-and-troubleshooting/050-dataguide/050-database-glossary.mdx` in future reviews as per user request. Issues in this file were addressed in PR #7185.
Applied to files:
content/800-guides/420-clerk-astro.mdx
📚 Learning: 2025-10-08T16:24:58.382Z
Learnt from: aidankmcalister
Repo: prisma/docs PR: 7165
File: content/800-guides/550-test-guide.mdx:168-176
Timestamp: 2025-10-08T16:24:58.382Z
Learning: When a review suggestion is marked as resolved but the suggested change was NOT implemented, do not re-suggest the same change in future reviews or commits. A resolved comment indicates the maintainer has intentionally decided not to implement the suggestion.
Applied to files:
content/800-guides/420-clerk-astro.mdx
🪛 LanguageTool
content/800-guides/420-clerk-astro.mdx
[uncategorized] ~55-~55: The official name of this software platform is spelled with a capital “H”.
Context: .... :::info For this guide, the Google, Github, and Email sign in options will be used...
(GITHUB)
⏰ Context from checks skipped due to timeout of 90000ms. You can increase the timeout in your CodeRabbit configuration to a maximum of 15 minutes (900000ms). (2)
- GitHub Check: Check internal links
- GitHub Check: Cloudflare Pages
mhartington
approved these changes
Nov 24, 2025
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Summary by CodeRabbit
✏️ Tip: You can customize this high-level summary in your review settings.