Skip to content

docs(examples/solid): rename 'astro' to 'ssr-astro', replace '@astrojs/tailwind' with Tailwind CSS v4 via '@tailwindcss/vite', and align it with the current Astro template - #12585

Open
sukvvon wants to merge 1 commit into
mainfrom
docs/solid-ssr-astro-tailwind-4
Open

sukvvon wants to merge 1 commit into
mainfrom
docs/solid-ssr-astro-tailwind-4

Conversation

@sukvvon

@sukvvon sukvvon commented Nov 12, 2026 •

Copy link
Copy Markdown
Member

🎯 Changes

  • Rename examples/solid/astro to examples/solid/ssr-astro to follow the <feature>-<framework> naming of the other examples. The example renders on the server (output: 'server') and shows whether each query was rendered on the server or the client. Update the package name, the docs/config.json link and label ("SSR (Astro)"), the README heading and the page title (TanStack Solid Query SSR Example (Astro)), and the lockfile importer.
  • Replace @astrojs/tailwind, whose astro peer range stops at v5 while the example uses astro 7, with Tailwind CSS v4 through @tailwindcss/vite, as the Astro Tailwind template does:
    • Add tailwindcss() to vite.plugins in astro.config.mjs.
    • Add src/styles/global.css with @import 'tailwindcss' and import it in MainLayout.astro.
    • Remove tailwind.config.mjs.
    • Update classes whose meaning changed in v4: rounded-sm → rounded-xs, rounded → rounded-sm, flex-shrink-0 → shrink-0, and add border-gray-200 to border, border-b and border-r, since the default border color is now currentColor.
  • Align the example with the current Astro minimal template:
    • tsconfig.json includes .astro/types.d.ts and **/* and excludes dist, which replaces src/env.d.ts and its ESLint ignore.
    • Remove the start script, which duplicated dev.
    • Drop .vercel/ from .gitignore.
    • Add // @ts-check to astro.config.mjs.

✅ Checklist

  • I have followed the steps in the Contributing guide.
  • I have tested code changes locally with pnpm run test:pr, or these tests do not apply to this pull request.
  • I have followed the AI contribution policy and fully understand the code in this pull request, including any code generated with AI assistance.

🚀 Release Impact

  • This change affects published code, and I have generated a changeset.
  • This change is docs/CI/dev-only (no release).

Summary by CodeRabbit

  • Documentation
    • Updated the Solid examples navigation label and example title to identify the Astro example as an SSR example.
  • Style
    • Refined borders, corner rounding, and sizing across the example’s navigation and Pokémon artwork.
  • Chores
    • Updated the example’s styling and project configuration.

…s/tailwind' with Tailwind CSS v4 via '@tailwindcss/vite', and align it with the current Astro template
@sukvvon sukvvon self-assigned this Nov 12, 2026
@changeset-bot

changeset-bot Bot commented Nov 12, 2026

Copy link
Copy Markdown

⚠️ No Changeset found

Latest commit: ada79c2

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

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

@coderabbitai

coderabbitai Bot commented Nov 12, 2026 •

Copy link
Copy Markdown
Contributor

Explain Change →

No actionable comments were generated in the recent review.

Walkthrough

The Solid Astro example updates its Tailwind integration and project configuration. Its navigation labels and page title now identify it as an SSR example, and several component styles have changed.

Changes: Solid SSR Astro Example

Layer / File(s) Summary
Update example tooling and styles
examples/solid/ssr-astro/package.json, examples/solid/ssr-astro/astro.config.mjs, examples/solid/ssr-astro/src/styles/global.css, examples/solid/ssr-astro/src/layouts/MainLayout.astro, examples/solid/ssr-astro/tsconfig.json, examples/solid/ssr-astro/eslint.config.js, examples/solid/astro/src/env.d.ts, examples/solid/astro/tailwind.config.mjs, examples/solid/ssr-astro/.gitignore
The example replaces the Astro Tailwind integration with the Tailwind Vite plugin, updates Tailwind CSS to version 4, imports Tailwind in the global stylesheet, and updates TypeScript settings. It also removes the prior environment and Tailwind configuration files, the ESLint ignore entry, and the .vercel/ ignore entry.
Update example labels and navigation
docs/config.json, examples/solid/ssr-astro/README.md, examples/solid/ssr-astro/src/layouts/MainLayout.astro
The navigation label and route, README heading, and page title identify the example as Solid Query SSR (Astro).
Adjust example component styles
examples/solid/ssr-astro/src/components/SolidApp.tsx
The artwork container and sidebar gain borders. Stat bars, Pokémon links, and avatars use smaller corner radii; avatar and navigation sizing classes are updated.

Estimated code review effort: 2 (Simple) | ~10 minutes

Change: Other

Possibly related PRs

  • TanStack/query#12583: This PR also edits the Solid Astro README and docs/config.json, so the README title changes may need to be reconciled.
Merge Risk: Minimal · up to ada79

This updates an example project's name, labels and Tailwind setup. No concrete merge-blocking risk was found, and the change does not affect shipped library code.

Pre-merge checks: Passed 4

Check name Status Explanation
Title check Passed The title names the rename from 'astro' to 'ssr-astro', which is the main change in the changeset. It also names the Tailwind CSS v4 migration via '@tailwindcss/vite' and the template alignment. The t…
Description check Passed The description follows the repository template. It has the Changes section with detailed bullets that explain the rename, the Tailwind CSS v4 migration, and the template alignment. The Checklist sect…
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.
Full details: Title check

Explanation

The title names the rename from 'astro' to 'ssr-astro', which is the main change in the changeset. It also names the Tailwind CSS v4 migration via '@tailwindcss/vite' and the template alignment. The title is long (21 words, 171 characters) but these changes are all present in the diff, so it is related to the changeset.

Full details: Description check

Explanation

The description follows the repository template. It has the Changes section with detailed bullets that explain the rename, the Tailwind CSS v4 migration, and the template alignment. The Checklist section is filled in and marked. The Release Impact section marks the docs/CI/dev-only option. The description gives the motivation for each change.

Finishing Touches

Generate unit tests (beta)

  • Commit to this branch
  • Create a new PR
  • Autofix · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

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

Recent review info

Run configuration

Commits

Reviewing files that changed from the base of the PR and between 70441f4 and ada79c2.

Files ignored due to path filters: 2

  • examples/solid/ssr-astro/public/emblem-light.svg is excluded by !**/*.svg
  • pnpm-lock.yaml is excluded by !**/pnpm-lock.yaml
Files selected for processing: 18

  • docs/config.json
  • examples/solid/astro/src/env.d.ts
  • examples/solid/astro/tailwind.config.mjs
  • examples/solid/ssr-astro/.gitignore
  • examples/solid/ssr-astro/README.md
  • examples/solid/ssr-astro/astro.config.mjs
  • examples/solid/ssr-astro/eslint.config.js
  • examples/solid/ssr-astro/package.json
  • examples/solid/ssr-astro/src/components/Link.tsx
  • examples/solid/ssr-astro/src/components/SolidApp.tsx
  • examples/solid/ssr-astro/src/layouts/MainLayout.astro
  • examples/solid/ssr-astro/src/pages/index.astro
  • examples/solid/ssr-astro/src/services/pokemons/api.ts
  • examples/solid/ssr-astro/src/services/pokemons/queries.ts
  • examples/solid/ssr-astro/src/services/pokemons/types.ts
  • examples/solid/ssr-astro/src/styles/global.css
  • examples/solid/ssr-astro/src/utils/index.ts
  • examples/solid/ssr-astro/tsconfig.json
Files with no reviewable changes: 4

  • examples/solid/astro/src/env.d.ts
  • examples/solid/astro/tailwind.config.mjs
  • examples/solid/ssr-astro/eslint.config.js
  • examples/solid/ssr-astro/.gitignore

Included review availability: This review used your included allowance. Your plan provides up to 10 included reviews per hour; 8 remain after this review.

@nx-cloud

nx-cloud Bot commented Nov 12, 2026 •

Copy link
Copy Markdown

View your CI Pipeline Execution ↗ for commit ada79c2

Command Status Duration Result
nx affected --targets=test:sherif,test:knip,tes... ✅ Succeeded 10m 28s View ↗
nx run-many --target=build --exclude=examples/*... ✅ Succeeded 30s View ↗

☁️ Nx Cloud last updated this comment at 2026-11-12 08:20:09 UTC

@github-actions

Copy link
Copy Markdown
Contributor

🚀 Changeset Version Preview

No changeset entries found. Merging this PR will not cause a version bump for any packages.

@pkg-pr-new

pkg-pr-new Bot commented Nov 12, 2026

Copy link
Copy Markdown
More templates

@tanstack/angular-query-experimental

npm i https://pkg.pr.new/@tanstack/angular-query-experimental@12585

@tanstack/eslint-plugin-query

npm i https://pkg.pr.new/@tanstack/eslint-plugin-query@12585

@tanstack/lit-query

npm i https://pkg.pr.new/@tanstack/lit-query@12585

@tanstack/preact-query

npm i https://pkg.pr.new/@tanstack/preact-query@12585

@tanstack/preact-query-devtools

npm i https://pkg.pr.new/@tanstack/preact-query-devtools@12585

@tanstack/preact-query-persist-client

npm i https://pkg.pr.new/@tanstack/preact-query-persist-client@12585

@tanstack/query-async-storage-persister

npm i https://pkg.pr.new/@tanstack/query-async-storage-persister@12585

@tanstack/query-broadcast-client-experimental

npm i https://pkg.pr.new/@tanstack/query-broadcast-client-experimental@12585

@tanstack/query-core

npm i https://pkg.pr.new/@tanstack/query-core@12585

@tanstack/query-devtools

npm i https://pkg.pr.new/@tanstack/query-devtools@12585

@tanstack/query-persist-client-core

npm i https://pkg.pr.new/@tanstack/query-persist-client-core@12585

@tanstack/query-sync-storage-persister

npm i https://pkg.pr.new/@tanstack/query-sync-storage-persister@12585

@tanstack/react-query

npm i https://pkg.pr.new/@tanstack/react-query@12585

@tanstack/react-query-devtools

npm i https://pkg.pr.new/@tanstack/react-query-devtools@12585

@tanstack/react-query-next-experimental

npm i https://pkg.pr.new/@tanstack/react-query-next-experimental@12585

@tanstack/react-query-persist-client

npm i https://pkg.pr.new/@tanstack/react-query-persist-client@12585

@tanstack/solid-query

npm i https://pkg.pr.new/@tanstack/solid-query@12585

@tanstack/solid-query-devtools

npm i https://pkg.pr.new/@tanstack/solid-query-devtools@12585

@tanstack/solid-query-persist-client

npm i https://pkg.pr.new/@tanstack/solid-query-persist-client@12585

@tanstack/svelte-query

npm i https://pkg.pr.new/@tanstack/svelte-query@12585

@tanstack/svelte-query-devtools

npm i https://pkg.pr.new/@tanstack/svelte-query-devtools@12585

@tanstack/svelte-query-persist-client

npm i https://pkg.pr.new/@tanstack/svelte-query-persist-client@12585

@tanstack/vue-query

npm i https://pkg.pr.new/@tanstack/vue-query@12585

@tanstack/vue-query-devtools

npm i https://pkg.pr.new/@tanstack/vue-query-devtools@12585

commit: ada79c2

@github-actions

Copy link
Copy Markdown
Contributor

size-limit report 📦

Path Size
react full 11.85 KB (0%)
react minimal 8.67 KB (0%)

This branch has not been deployed

No deployments
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