8000 docs: Add Tanstack Start start quickstart guide by dshukertjr · Pull Request #40887 · supabase/supabase · GitHub
[go: up one dir, main page]

Skip to content

Conversation

@dshukertjr
Copy link
Member
@dshukertjr dshukertjr commented Nov 28, 2025

I have read the CONTRIBUTING.md file.

YES

What kind of change does this PR introduce?

Adds a Tanstack Start quickstart guide.

Summary by CodeRabbit

  • Documentation
    • Added a new TanStack Start quickstart guide with comprehensive step-by-step instructions for integrating Supabase, including database setup, environment configuration, client initialization, and implementation examples.

✏️ Tip: You can customize this high-level summary in your review settings.

@vercel
Copy link
vercel bot commented Nov 28, 2025

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

Project Deployment Review Updated (UTC)
cms Ready Ready Preview, Comment Dec 16, 2025 2:11pm
design-system Ready Ready Preview, Comment Dec 16, 2025 2:11pm
docs Ready Ready Preview, Comment Dec 16, 2025 2:11pm
studio-self-hosted Ready Ready Preview, Comment Dec 16, 2025 2:11pm
studio-staging Ready Ready Preview, Comment Dec 16, 2025 2:11pm
ui-library Ready Ready Preview, Comment Dec 16, 2025 2:11pm
zone-www-dot-com Ready Ready Preview, Comment Dec 16, 2025 2:11pm
1 Skipped Deployment
Project Deployment Review Updated (UTC)
studio Ignored Ignored Dec 16, 2025 2:11pm

@supabase
Copy link
supabase bot commented Nov 28, 2025

This pull request has been ignored for the connected project xguihxuzqibwxjnimxev because there are no changes detected in supabase directory. You can change this behaviour in Project Integrations Settings ↗︎.


Preview Branches by Supabase.
Learn more about Supabase Branching ↗︎.

@dshukertjr dshukertjr requested a review from a team November 28, 2025 06:39
@github-actions github-actions bot added the documentation Improvements or additions to documentation label Nov 28, 2025
@coderabbitai
Copy link
Contributor
coderabbitai bot commented 8000 Dec 16, 2025

Walkthrough

Three files updated to add TanStack Start as a new framework quickstart option. A navigation menu entry, a new quickstart guide file with seven setup steps, and a quickstarts array entry were added to surface this option across the documentation.

Changes

Cohort / File(s) Summary
Navigation & Quickstarts Configuration
apps/docs/components/Navigation/NavigationMenu/NavigationMenu.constants.ts, apps/docs/features/command/Quickstarts.tsx
Added TanStack Start entries to the Getting Started navigation menu and quickstarts array, making the framework discoverable in navigation and command flows.
Quickstart Guide Content
apps/docs/content/guides/getting-started/quickstarts/tanstack.mdx
New MDX guide file with seven-step TanStack Start setup workflow, covering database setup, app creation, Supabase client initialization, environment configuration, sample data integration, and next steps.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~8 minutes

  • All changes are additive entries following established patterns in navigation constants, quickstarts array, and MDX documentation templates
  • No logic modifications, API changes, or control-flow alterations
  • Content structure mirrors existing quickstart guides with standard components and sections

Poem

🐰 A rabbit hops through docs so grand,
New paths for TanStack Start now planned,
With seven steps and guides so clear,
The framework quickstart's finally here!

Pre-merge checks and finishing touches

❌ Failed checks (1 warning)
Check name Status Explanation Resolution
Description check ⚠️ Warning The description is largely incomplete; it only fills two of five required sections and lacks current behavior, new behavior details, and additional context. Complete the description by adding details about what issue this resolves, describing the new behavior (new MDX file, navigation update, quickstart entry), and providing any relevant context or links to the TanStack Start documentation.
✅ Passed checks (2 passed)
Check name Status Explanation
Title check ✅ Passed The title clearly and concisely describes the main change: adding a TanStack Start quickstart guide to the documentation.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
✨ Finishing touches
  • 📝 Generate docstrings
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Post copyable unit tests in a comment
  • Commit unit tests in branch guides/tanstack

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

Copy link
Contributor
@ChrisChinchilla ChrisChinchilla left a comment

Choose a reason for hiding this comment

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

Again I just made a small change to introduce updates

Copy link
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: 1

🧹 Nitpick comments (1)
apps/docs/content/guides/getting-started/quickstarts/tanstack.mdx (1)

113-136: Query implementation is correct for a quickstart.

The code properly uses TanStack Router's loader pattern and optional chaining provides basic safety. For production use, consider adding error handling to the loader function.

For production code, consider adding error handling:

loader: async () => {
  const { data: instruments, error } = await supabase.from('instruments').select()
  if (error) throw error
  return { instruments }
},
📜 Review details

Configuration used: CodeRabbit UI

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between cf17967 and dcd466e.

📒 Files selected for processing (3)
  • apps/docs/components/Navigation/NavigationMenu/NavigationMenu.constants.ts (1 hunks)
  • apps/docs/content/guides/getting-started/quickstarts/tanstack.mdx (1 hunks)
  • apps/docs/features/command/Quickstarts.tsx (1 hunks)
🧰 Additional context used
🧠 Learnings (1)
📚 Learning: 2025-12-11T02:39:49.745Z
Learnt from: CR
Repo: supabase/supabase PR: 0
File: .cursor/rules/docs-test-requirements.mdc:0-0
Timestamp: 2025-12-11T02:39:49.745Z
Learning: Applies to apps/docs/**/*.{test,spec}.ts : Before running tests in the docs application, check Supabase status using `pnpm supabase status`. If Supabase is not running, start it with `pnpm supabase start`. Reset the database with `pnpm supabase db reset --local` to ensure clean state. Run tests using `pnpm run -F docs test:local:unwatch` (without watch mode)

Applied to files:

  • apps/docs/content/guides/getting-started/quickstarts/tanstack.mdx
⏰ 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: build
  • GitHub Check: typecheck
🔇 Additional comments (5)
apps/docs/features/command/Quickstarts.tsx (1)

38-41: LGTM! TanStack Start quickstart entry added correctly.

The new quickstart entry follows the established pattern and is consistent with other framework entries in the array.

apps/docs/components/Navigation/NavigationMenu/NavigationMenu.constants.ts (1)

374-377: LGTM! Navigation entry added correctly.

The new TanStack Start entry is properly formatted and positioned within the Framework Quickstarts section, with a URL that matches the quickstart command entry.

apps/docs/content/guides/getting-started/quickstarts/tanstack.mdx (3)

1-6: LGTM! Frontmatter is well-structured.

The metadata is properly formatted with clear title and subtitle that align with the quickstart guide pattern.


92-99: LGTM! Supabase client initialization is correct.

The code properly uses Vite's import.meta.env to access environment variables, which is the correct approach for TanStack Start applications.


162-164: The URL paths in the "Next steps" section are correct and consistent with the documentation structure.

All quickstart guides (tanstack, nextjs, reactjs, sveltekit) consistently use the /docs/guides/... format for internal documentation links, which matches the actual URL structure of the Supabase documentation site (supabase.com/docs/guides/...). No changes needed.

Comment on lines +60 to +62
<ProjectConfigVariables variable="url" />
<ProjectConfigVariables variable="publishable" />
<ProjectConfigVariables variable="anon" />
Copy link
Contributor

Choose a reason for hiding this comment

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

⚠️ Potential issue | 🟡 Minor

Remove redundant variable declaration.

Line 62 declares an anon variable, but it's not used in the .env file (lines 71-72) or in the client initialization (lines 96-97). The "anon" key and "publishable" key refer to the same Supabase credential. Either remove line 62 or clarify that these are interchangeable terms.

Apply this diff to remove the redundant line:

     <ProjectConfigVariables variable="url" />
     <ProjectConfigVariables variable="publishable" />
-    <ProjectConfigVariables variable="anon" />
📝 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
<ProjectConfigVariables variable="url" />
<ProjectConfigVariables variable="publishable" />
<ProjectConfigVariables variable="anon" />
<ProjectConfigVariables variable="url" />
<ProjectConfigVariables variable="publishable" />
🤖 Prompt for AI Agents
In apps/docs/content/guides/getting-started/quickstarts/tanstack.mdx around
lines 60 to 62, the ProjectConfigVariables variable="anon" declaration is
redundant; remove the entire line declaring anon (line 62) so only url and
publishable remain, and optionally add a brief parenthetical note elsewhere
clarifying that "publishable" and "anon" refer to the same Supabase credential
if you want to explain terminology consistency.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants

0