Skip to content

TEMP COMPUTE DOC - INTERNAL USAGE#7800

Open
ArthurGamby wants to merge 3 commits intomainfrom
docs/prisma-compute-quickstart
Open

TEMP COMPUTE DOC - INTERNAL USAGE#7800
ArthurGamby wants to merge 3 commits intomainfrom
docs/prisma-compute-quickstart

Conversation

@ArthurGamby
Copy link
Copy Markdown
Contributor

@ArthurGamby ArthurGamby commented Apr 15, 2026

Summary

  • New top-level Compute section under apps/docs/content/docs/compute/: overview, Next.js and Bun quickstarts, dual-CLI reference (@looma/prisma-cli + @prisma/compute-cli) including env-var management, log streaming with the 10-min / single-stream EA limits, and a consolidated limitations page.
  • Wires the Compute tab into the v7 top navbar (src/lib/layout.shared.tsx) between Postgres and CLI. v6 nav is untouched.
  • v7-only: nothing added to content/docs.v6/.

Source material: How the hell do I compute? + CLI --help output for both @looma/prisma-cli and @prisma/compute-cli (so command flags are accurate, not guessed). Linear project: Compute until Offsite.

Intended audience: internal hackathon / EA users.

Test plan

  • pnpm --filter docs dev and open http://localhost:3001/docs/v7/compute — confirm the Compute tab appears in the navbar between Postgres and CLI, with the Cpu icon and the Introduction / Quickstart / CLI / More sidebar sections.
  • Click into each page (index, quickstart-nextjs, quickstart-bun, cli, logs, limitations) and verify it renders with the early-access badge and no MDX compile errors.
  • Open http://localhost:3001/docs/v6/… — confirm Compute does not appear in the v6 navbar or sidebar.
  • Spot-check one code example per quickstart by running it against the current CLI (Next.js path first, due to the output: "standalone" gotcha).

🤖 Generated with Claude Code

Summary by CodeRabbit

Release Notes

  • Documentation
    • Added comprehensive Compute documentation covering deployment of Next.js and Bun applications, including CLI usage, quickstart guides, environment variable management, log streaming, and current platform limitations.

Adds a new top-level Compute section under apps/docs covering the EA
release: overview, Next.js and Bun quickstarts, dual-CLI reference for
@looma/prisma-cli and @prisma/compute-cli (incl. env var management),
log streaming with the 10-min / single-stream EA limits, and a
consolidated limitations page. Also wires the Compute tab into the v7
top navbar.

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

vercel bot commented Apr 15, 2026

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

Project Deployment Actions Updated (UTC)
blog Ready Ready Preview, Comment Apr 15, 2026 11:23am
docs Ready Ready Preview, Comment Apr 15, 2026 11:23am
eclipse Ready Ready Preview, Comment Apr 15, 2026 11:23am
site Ready Ready Preview, Comment Apr 15, 2026 11:23am

Request Review

@github-actions
Copy link
Copy Markdown
Contributor

github-actions bot commented Apr 15, 2026

🍈 Lychee Link Check Report

2 links: ✅ 2 OK | 🚫 0 errors | 🔀 0 redirects | 👻 0 excluded

✅ All links are working!


Full Statistics Table
Status Count
✅ Successful 2
🔀 Redirected 0
👻 Excluded 0
🚫 Errors 0
⛔ Unsupported 0
⏳ Timeouts 0
❓ Unknown 0

@argos-ci
Copy link
Copy Markdown

argos-ci bot commented Apr 15, 2026

The latest updates on your projects. Learn more about Argos notifications ↗︎

Build Status Details Updated (UTC)
default (Inspect) ⚠️ Changes detected (Review) 1 changed Apr 15, 2026, 11:29 AM

@coderabbitai
Copy link
Copy Markdown
Contributor

coderabbitai bot commented Apr 15, 2026

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Run ID: f92a9311-f902-4ac6-a5d9-c72d7ad698f4

📥 Commits

Reviewing files that changed from the base of the PR and between a491937 and 99ed136.

📒 Files selected for processing (2)
  • apps/docs/content/docs/compute/index.mdx
  • apps/docs/content/docs/compute/meta.json
✅ Files skipped from review due to trivial changes (2)
  • apps/docs/content/docs/compute/meta.json
  • apps/docs/content/docs/compute/index.mdx

Walkthrough

Added new documentation section for Prisma Compute with a comprehensive reference guide covering deployment workflows for Next.js and Bun applications. Includes quickstart instructions, CLI command documentation, environment variable management, and logging features, alongside supporting navigation and configuration updates.

Changes

Cohort / File(s) Summary
Compute Documentation
apps/docs/content/docs/compute/index.mdx
New comprehensive guide covering Prisma Compute deployment, including CLI command references, authentication, deploy workflows, environment variable management, log streaming, and feature limitations for Next.js and Bun apps.
Navigation & Configuration
apps/docs/content/docs/compute/meta.json, apps/docs/content/docs/meta.json, apps/docs/src/lib/layout.shared.tsx
Added compute section metadata, registered compute route in docs configuration, and added corresponding navigation link to the main layout sidebar.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~12 minutes

🚥 Pre-merge checks | ✅ 3
✅ Passed checks (3 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title accurately describes the main change: adding a new Prisma Compute documentation section for Early Access users. It is concise, specific, and clearly summarizes the primary addition.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.


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 and usage tips.

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: 3

🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Inline comments:
In `@apps/docs/content/docs/compute/cli.mdx`:
- Around line 111-127: The examples use a unicode ellipsis placeholder
("sk_live_…") which can be miscopied into shells; update the command examples
shown for npx `@looma/prisma-cli` app update-env and bunx `@prisma/compute-cli` env
update to use explicit, safe placeholders like <your-stripe-key> or
YOUR_STRIPE_KEY (and similarly explicit placeholders for DATABASE_URL) so
readers copy a clear token instead of an ellipsis.
- Around line 7-24: The spellcheck CI is failing on the token "looma" in this
MDX doc; either add a local cspell ignore directive for looma at the top of this
MDX file (e.g., a cspell:ignore declaration) or add "looma" to the project's
cspell dictionary (cspell.json -> words array) so that occurrences like the
package name and table entries are accepted; update the doc and commit the
change so CI picks up the new ignore.

In `@apps/docs/content/docs/compute/limitations.mdx`:
- Line 19: Spellcheck is failing because the package scope `looma` (seen in the
token `@looma/prisma-cli`) is not in the cspell dictionary; fix by either adding
"looma" to the shared cspell dictionary (e.g., add "looma" into the project's
cspell word list) or add a page-local directive at the top of the MDX file using
a cspell:words comment (e.g., `<!-- cspell:words looma -->`) to whitelist
`looma` for this and sibling pages; update the shared cspell word list if you
want a global fix, otherwise add the `cspell:words` directive inside the Compute
docs MDX files that reference `@looma/prisma-cli`.
🪄 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: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Run ID: 459f48b3-84e8-4432-a72a-693775e64c79

📥 Commits

Reviewing files that changed from the base of the PR and between 9bcb676 and a491937.

📒 Files selected for processing (9)
  • apps/docs/content/docs/compute/cli.mdx
  • apps/docs/content/docs/compute/index.mdx
  • apps/docs/content/docs/compute/limitations.mdx
  • apps/docs/content/docs/compute/logs.mdx
  • apps/docs/content/docs/compute/meta.json
  • apps/docs/content/docs/compute/quickstart-bun.mdx
  • apps/docs/content/docs/compute/quickstart-nextjs.mdx
  • apps/docs/content/docs/meta.json
  • apps/docs/src/lib/layout.shared.tsx

Comment thread apps/docs/content/docs/compute/cli.mdx Outdated
Comment on lines +7 to +24
metaDescription: Reference for the Prisma Compute CLIs. Authentication, deploy, and environment variable commands for @looma/prisma-cli and @prisma/compute-cli.
---

Two CLIs currently target Prisma Compute during Early Access. This page documents the commands needed day-to-day: install, authenticate, deploy, and manage environment variables.

| Package | Binary | Typical invocation |
|---|---|---|
| [`@looma/prisma-cli`](https://www.npmjs.com/package/@looma/prisma-cli) | `prisma` | `npx @looma/prisma-cli …` |
| [`@prisma/compute-cli`](https://www.npmjs.com/package/@prisma/compute-cli) | `compute` | `bunx @prisma/compute-cli …` |

## Authentication

Run an interactive browser flow once per machine. Credentials are stored locally.

### Using `@looma/prisma-cli`

```bash
npx @looma/prisma-cli auth login
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

⚠️ Potential issue | 🟠 Major

Fix CI blocker: cspell rejects looma in multiple spots

Lines 7, 14, 21, and 24 currently fail spellcheck. Please add a local cspell ignore (or project dictionary entry) so docs CI can pass.

Proposed fix (local to this doc)
 ---
 title: CLI reference
 description: Authenticate, deploy, and manage environment variables for Prisma Compute from the CLI.
 badge: early-access
 url: /compute/cli
 metaTitle: CLI reference | Prisma Compute
 metaDescription: Reference for the Prisma Compute CLIs. Authentication, deploy, and environment variable commands for `@looma/prisma-cli` and `@prisma/compute-cli`.
 ---
 
+<!-- cspell:ignore looma -->
+
 Two CLIs currently target Prisma Compute during Early Access. This page documents the commands needed day-to-day: install, authenticate, deploy, and manage environment variables.
🧰 Tools
🪛 GitHub Actions: Spellcheck

[error] 7-7: cspell reported unknown word "looma" at line 7 (e.g., "-- variable commands for @looma/prisma-cli and @prisma").


[error] 14-14: cspell reported unknown word "looma" in a markdown table/link at line 14.


[error] 14-14: cspell reported unknown word "looma" in inline code at line 14.


[error] 21-21: cspell reported unknown word "looma" at line 21 (heading: "### Using @looma/prisma-cli").


[error] 24-24: cspell reported unknown word "looma" at line 24 (command: "npx @looma/prisma-cli auth login").

🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@apps/docs/content/docs/compute/cli.mdx` around lines 7 - 24, The spellcheck
CI is failing on the token "looma" in this MDX doc; either add a local cspell
ignore directive for looma at the top of this MDX file (e.g., a cspell:ignore
declaration) or add "looma" to the project's cspell dictionary (cspell.json ->
words array) so that occurrences like the package name and table entries are
accepted; update the doc and commit the change so CI picks up the new ignore.

Comment thread apps/docs/content/docs/compute/cli.mdx Outdated
Comment on lines +111 to +127
npx @looma/prisma-cli app update-env --app my-app --env STRIPE_KEY=sk_live_…
```

List the current values:

```bash
npx @looma/prisma-cli app list-env
npx @looma/prisma-cli app list-env --app my-app
```

#### Using `@prisma/compute-cli`

```bash
bunx @prisma/compute-cli env update --env DATABASE_URL=postgresql://example
bunx @prisma/compute-cli env update \
--env STRIPE_KEY=sk_live_… \
--env NODE_ENV=production
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

⚠️ Potential issue | 🟡 Minor

Use explicit placeholders instead of in secret examples

On Line 111 and Line 126, sk_live_… is easy to miscopy and the unicode ellipsis can be pasted literally in shells. Prefer clear placeholders like <your-stripe-key>.

Suggested doc tweak
-npx `@looma/prisma-cli` app update-env --app my-app --env STRIPE_KEY=sk_live_…
+npx `@looma/prisma-cli` app update-env --app my-app --env STRIPE_KEY=<your-stripe-key>
...
-  --env STRIPE_KEY=sk_live_… \
+  --env STRIPE_KEY=<your-stripe-key> \
📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change
npx @looma/prisma-cli app update-env --app my-app --env STRIPE_KEY=sk_live_
```
List the current values:
```bash
npx @looma/prisma-cli app list-env
npx @looma/prisma-cli app list-env --app my-app
```
#### Using `@prisma/compute-cli`
```bash
bunx @prisma/compute-cli env update --env DATABASE_URL=postgresql://example
bunx @prisma/compute-cli env update \
--env STRIPE_KEY=sk_live_\
--env NODE_ENV=production
npx `@looma/prisma-cli` app update-env --app my-app --env STRIPE_KEY=<your-stripe-key>
🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@apps/docs/content/docs/compute/cli.mdx` around lines 111 - 127, The examples
use a unicode ellipsis placeholder ("sk_live_…") which can be miscopied into
shells; update the command examples shown for npx `@looma/prisma-cli` app
update-env and bunx `@prisma/compute-cli` env update to use explicit, safe
placeholders like <your-stripe-key> or YOUR_STRIPE_KEY (and similarly explicit
placeholders for DATABASE_URL) so readers copy a clear token instead of an
ellipsis.


## CLI

- **Two CLIs coexist.** `@looma/prisma-cli` (unified `prisma app …`) is the direction of travel; `@prisma/compute-cli` (original `compute …`) is the fallback for features or fixes that haven't reached the new CLI yet.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

⚠️ Potential issue | 🟠 Major

CI blocker: cspell rejects looma across Compute docs.

Spellcheck is failing on a legitimate package scope. Add looma to the shared cspell dictionary (preferred), or annotate with a local cspell:words directive to unblock this page and sibling pages.

Suggested minimal page-local fix (if global dictionary update is deferred)
 ---
 title: Known limitations
 description: What is and isn't supported in Prisma Compute during Early Access.
 badge: early-access
 url: /compute/limitations
 metaTitle: Known limitations | Prisma Compute
 metaDescription: A running list of known limitations in Prisma Compute during the Early Access window.
 ---
+<!-- cspell:words looma -->
🧰 Tools
🪛 GitHub Actions: Spellcheck

[error] 19-19: cspell reported unknown word "looma" at line 19.

🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@apps/docs/content/docs/compute/limitations.mdx` at line 19, Spellcheck is
failing because the package scope `looma` (seen in the token
`@looma/prisma-cli`) is not in the cspell dictionary; fix by either adding
"looma" to the shared cspell dictionary (e.g., add "looma" into the project's
cspell word list) or add a page-local directive at the top of the MDX file using
a cspell:words comment (e.g., `<!-- cspell:words looma -->`) to whitelist
`looma` for this and sibling pages; update the shared cspell word list if you
want a global fix, otherwise add the `cspell:words` directive inside the Compute
docs MDX files that reference `@looma/prisma-cli`.

Merges the six sub-pages (quickstarts, CLI, logs, limitations) into one
page at /docs/v7/compute, using Tabs for the Next.js|Bun choice and
CodeBlockTabs for the @looma|@prisma/compute-cli choice — same
ergonomic as npm|pnpm|yarn|bun code switching. Simpler for internal
EA users who want everything in one place.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
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