Skip to content

Conversation

@sarah11918
Copy link
Member

@sarah11918 sarah11918 commented Nov 18, 2025

Description (required)

Updates our deployment guides navigation component to work like the other (newer) ones. In particular:

  • replaces a hard-coded array that needs updating for every new guide with new deploy guide frontmatter properties (service name, logo to identify the logo icon used; supports array of deployment types)~~
  • now sorts based on id and displays service based on sidebar.label (so, a sidebar label prop is now required, and can be fully displayed with localization e.g. "AWS avec SST" since this is now text provided by the translators in the MDX file itself)
  • updates all existing deployment guides (including translations) to include these new properties
  • updates the content collections config schema for deployment guides to include these new properties/requirements
  • alphabetizes the entries, like our other navigation components
  • renames some files (and adds redirects) for consistency of ordering in both the sidebar and the navigation grid itself (e.g. "AWS via SST" should show up alphabetically with "AWS" in both places)

TODOS:

  • redirect changed files

NICE TO HAVE FOLLOW UPS:

  • CSS visual issue with badge labels

@netlify
Copy link

netlify bot commented Nov 18, 2025

Deploy Preview for astro-docs-2 ready!

Name Link
🔨 Latest commit cc3f8f9
🔍 Latest deploy log https://app.netlify.com/projects/astro-docs-2/deploys/69249de987e6660008400cc7
😎 Deploy Preview https://deploy-preview-12735--astro-docs-2.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.

@github-actions github-actions bot added the i18n Anything to do with internationalization & translation efforts - ask @YanThomas for help! label Nov 18, 2025
@sarah11918 sarah11918 changed the title Deploy-guides-alpha New deploy guide navigation component Nov 18, 2025
@astrobot-houston
Copy link
Contributor

astrobot-houston commented Nov 18, 2025

Lunaria Status Overview

🌑 This pull request will not trigger status changes.

Learn more

Lunaria automatically ignores changes on specific PRs by adding a ignored keyword in its title. Found: i18nIgnore.

You can change this by either removing the keyword above from the PR's title, or modifying the ignoreKeywords property in your Lunaria configuration file.

Tracked Files

Note

The notes below indicate what would happen if the pull request is merged when triggering status changes. Since a ignored keyword was found in the PR's title, the status changes indicated below won't be applied.

File Note
de/guides/deploy/aws-via-flightcontrol.mdx Localization added, will be marked as complete.
de/guides/deploy/buddy.mdx Localization changed, will be marked as complete.
de/guides/deploy/cleavr.mdx Localization changed, will be marked as complete.
de/guides/deploy/deno.mdx Localization changed, will be marked as complete.
de/guides/deploy/firebase.mdx Localization added, will be marked as complete.
de/guides/deploy/gitlab.mdx Localization changed, will be marked as complete.
de/guides/deploy/google-cloud.mdx Localization changed, will be marked as complete.
de/guides/deploy/heroku.mdx Localization changed, will be marked as complete.
en/guides/backend/google-firebase.mdx Source changed, localizations will be marked as outdated.
en/guides/deploy/aws-via-flightcontrol.mdx Localization added, will be marked as complete.
en/guides/deploy/aws-via-sst.mdx Localization added, will be marked as complete.
en/guides/deploy/aws.mdx Source changed, localizations will be marked as outdated.
en/guides/deploy/azion.mdx Source changed, localizations will be marked as outdated.
en/guides/deploy/buddy.mdx Source changed, localizations will be marked as outdated.
en/guides/deploy/cleavr.mdx Source changed, localizations will be marked as outdated.
en/guides/deploy/clever-cloud.mdx Source changed, localizations will be marked as outdated.
en/guides/deploy/cloudflare.mdx Source changed, localizations will be marked as outdated.
en/guides/deploy/cloudray.mdx Source changed, localizations will be marked as outdated.
en/guides/deploy/deno.mdx Source changed, localizations will be marked as outdated.
en/guides/deploy/deployhq.mdx Source changed, localizations will be marked as outdated.
en/guides/deploy/firebase.mdx Localization added, will be marked as complete.
en/guides/deploy/fleek.mdx Source changed, localizations will be marked as outdated.
en/guides/deploy/flyio.mdx Source changed, localizations will be marked as outdated.
en/guides/deploy/github.mdx Source changed, localizations will be marked as outdated.
en/guides/deploy/gitlab.mdx Source changed, localizations will be marked as outdated.
en/guides/deploy/google-cloud.mdx Source changed, localizations will be marked as outdated.
en/guides/deploy/heroku.mdx Source changed, localizations will be marked as outdated.
en/guides/deploy/juno.mdx Source changed, localizations will be marked as outdated.
en/guides/deploy/kinsta.mdx Source changed, localizations will be marked as outdated.
en/guides/deploy/microsoft-azure.mdx Source changed, localizations will be marked as outdated.
en/guides/deploy/netlify.mdx Source changed, localizations will be marked as outdated.
en/guides/deploy/railway.mdx Source changed, localizations will be marked as outdated.
en/guides/deploy/render.mdx Source changed, localizations will be marked as outdated.
en/guides/deploy/seenode.mdx Source changed, localizations will be marked as outdated.
en/guides/deploy/stormkit.mdx Source changed, localizations will be marked as outdated.
en/guides/deploy/surge.mdx Source changed, localizations will be marked as outdated.
en/guides/deploy/vercel.mdx Source changed, localizations will be marked as outdated.
en/guides/deploy/zeabur.mdx Source changed, localizations will be marked as outdated.
en/guides/deploy/zephyr.mdx Source changed, localizations will be marked as outdated.
en/guides/deploy/zerops.mdx Source changed, localizations will be marked as outdated.
es/guides/backend/google-firebase.mdx Localization changed, will be marked as complete.
es/guides/deploy/azion.mdx Localization changed, will be marked as complete.
es/guides/deploy/clever-cloud.mdx Localization changed, will be marked as complete.
es/guides/deploy/cloudray.mdx Localization changed, will be marked as complete.
es/guides/deploy/fleek.mdx Localization changed, will be marked as complete.
es/guides/deploy/github.mdx Localization changed, will be marked as complete.
es/guides/deploy/railway.mdx Localization changed, will be marked as complete.
fr/guides/backend/google-firebase.mdx Localization changed, will be marked as complete.
fr/guides/deploy/aws-via-flightcontrol.mdx Localization added, will be marked as complete.
fr/guides/deploy/aws-via-sst.mdx Localization added, will be marked as complete.
fr/guides/deploy/aws.mdx Localization changed, will be marked as complete.
fr/guides/deploy/azion.mdx Localization changed, will be marked as complete.
fr/guides/deploy/buddy.mdx Localization changed, will be marked as complete.
fr/guides/deploy/cleavr.mdx Localization changed, will be marked as complete.
fr/guides/deploy/clever-cloud.mdx Localization changed, will be marked as complete.
fr/guides/deploy/cloudflare.mdx Localization changed, will be marked as complete. 🔄️
fr/guides/deploy/cloudray.mdx Localization changed, will be marked as complete.
fr/guides/deploy/deno.mdx Localization changed, will be marked as complete.
fr/guides/deploy/deployhq.mdx Localization changed, will be marked as complete.
fr/guides/deploy/firebase.mdx Localization added, will be marked as complete.
fr/guides/deploy/fleek.mdx Localization changed, will be marked as complete.
fr/guides/deploy/flyio.mdx Localization changed, will be marked as complete.
fr/guides/deploy/github.mdx Localization changed, will be marked as complete.
fr/guides/deploy/gitlab.mdx Localization changed, will be marked as complete.
fr/guides/deploy/google-cloud.mdx Localization changed, will be marked as complete.
fr/guides/deploy/heroku.mdx Localization changed, will be marked as complete.
fr/guides/deploy/juno.mdx Localization changed, will be marked as complete.
fr/guides/deploy/kinsta.mdx Localization changed, will be marked as complete.
fr/guides/deploy/microsoft-azure.mdx Localization changed, will be marked as complete.
fr/guides/deploy/netlify.mdx Localization changed, will be marked as complete.
fr/guides/deploy/railway.mdx Localization changed, will be marked as complete.
fr/guides/deploy/render.mdx Localization changed, will be marked as complete.
fr/guides/deploy/seenode.mdx Localization changed, will be marked as complete.
fr/guides/deploy/stormkit.mdx Localization changed, will be marked as complete.
fr/guides/deploy/surge.mdx Localization changed, will be marked as complete.
fr/guides/deploy/vercel.mdx Localization changed, will be marked as complete.
fr/guides/deploy/zeabur.mdx Localization changed, will be marked as complete.
fr/guides/deploy/zephyr.mdx Localization changed, will be marked as complete.
fr/guides/deploy/zerops.mdx Localization changed, will be marked as complete.
ja/guides/backend/google-firebase.mdx Localization changed, will be marked as complete.
ja/guides/deploy/render.mdx Localization changed, will be marked as complete.
ko/guides/backend/google-firebase.mdx Localization changed, will be marked as complete.
ko/guides/deploy/aws-via-flightcontrol.mdx Localization added, will be marked as complete.
ko/guides/deploy/aws-via-sst.mdx Localization added, will be marked as complete.
ko/guides/deploy/aws.mdx Localization changed, will be marked as complete.
ko/guides/deploy/azion.mdx Localization changed, will be marked as complete.
ko/guides/deploy/buddy.mdx Localization changed, will be marked as complete.
ko/guides/deploy/cleavr.mdx Localization changed, will be marked as complete.
ko/guides/deploy/clever-cloud.mdx Localization changed, will be marked as complete.
ko/guides/deploy/cloudflare.mdx Localization changed, will be marked as complete. 🔄️
ko/guides/deploy/cloudray.mdx Localization changed, will be marked as complete.
ko/guides/deploy/deno.mdx Localization changed, will be marked as complete.
ko/guides/deploy/deployhq.mdx Localization changed, will be marked as complete.
ko/guides/deploy/firebase.mdx Localization added, will be marked as complete.
ko/guides/deploy/fleek.mdx Localization changed, will be marked as complete.
ko/guides/deploy/flyio.mdx Localization changed, will be marked as complete.
ko/guides/deploy/github.mdx Localization changed, will be marked as complete.
ko/guides/deploy/gitlab.mdx Localization changed, will be marked as complete.
ko/guides/deploy/google-cloud.mdx Localization changed, will be marked as complete.
ko/guides/deploy/heroku.mdx Localization changed, will be marked as complete.
ko/guides/deploy/juno.mdx Localization changed, will be marked as complete.
ko/guides/deploy/kinsta.mdx Localization changed, will be marked as complete.
ko/guides/deploy/microsoft-azure.mdx Localization changed, will be marked as complete.
ko/guides/deploy/netlify.mdx Localization changed, will be marked as complete.
ko/guides/deploy/railway.mdx Localization changed, will be marked as complete.
ko/guides/deploy/render.mdx Localization changed, will be marked as complete.
ko/guides/deploy/seenode.mdx Localization changed, will be marked as complete.
ko/guides/deploy/stormkit.mdx Localization changed, will be marked as complete.
ko/guides/deploy/surge.mdx Localization changed, will be marked as complete.
ko/guides/deploy/vercel.mdx Localization changed, will be marked as complete.
ko/guides/deploy/zeabur.mdx Localization changed, will be marked as complete.
ko/guides/deploy/zephyr.mdx Localization changed, will be marked as complete.
ko/guides/deploy/zerops.mdx Localization changed, will be marked as complete.
pt-br/guides/deploy/azion.mdx Localization changed, will be marked as complete.
pt-br/guides/deploy/fleek.mdx Localization changed, will be marked as complete.
pt-br/guides/deploy/stormkit.mdx Localization changed, will be marked as complete.
pt-br/guides/deploy/zeabur.mdx Localization changed, will be marked as complete.
pt-br/guides/deploy/zerops.mdx Localization changed, will be marked as complete.
ru/guides/deploy/github.mdx Localization changed, will be marked as complete.
zh-cn/guides/backend/google-firebase.mdx Localization changed, will be marked as complete.
zh-cn/guides/deploy/aws-via-flightcontrol.mdx Localization added, will be marked as complete.
zh-cn/guides/deploy/aws-via-sst.mdx Localization added, will be marked as complete.
zh-cn/guides/deploy/aws.mdx Localization changed, will be marked as complete.
zh-cn/guides/deploy/azion.mdx Localization changed, will be marked as complete.
zh-cn/guides/deploy/buddy.mdx Localization changed, will be marked as complete.
zh-cn/guides/deploy/cleavr.mdx Localization changed, will be marked as complete.
zh-cn/guides/deploy/clever-cloud.mdx Localization changed, will be marked as complete.
zh-cn/guides/deploy/cloudflare.mdx Localization changed, will be marked as complete. 🔄️
zh-cn/guides/deploy/cloudray.mdx Localization changed, will be marked as complete.
zh-cn/guides/deploy/deno.mdx Localization changed, will be marked as complete.
zh-cn/guides/deploy/firebase.mdx Localization added, will be marked as complete.
zh-cn/guides/deploy/fleek.mdx Localization changed, will be marked as complete.
zh-cn/guides/deploy/flyio.mdx Localization changed, will be marked as complete.
zh-cn/guides/deploy/github.mdx Localization changed, will be marked as complete.
zh-cn/guides/deploy/gitlab.mdx Localization changed, will be marked as complete.
zh-cn/guides/deploy/google-cloud.mdx Localization changed, will be marked as complete.
zh-cn/guides/deploy/heroku.mdx Localization changed, will be marked as complete.
zh-cn/guides/deploy/kinsta.mdx Localization changed, will be marked as complete.
zh-cn/guides/deploy/microsoft-azure.mdx Localization changed, will be marked as complete.
zh-cn/guides/deploy/netlify.mdx Localization changed, will be marked as complete.
zh-cn/guides/deploy/railway.mdx Localization changed, will be marked as complete.
zh-cn/guides/deploy/render.mdx Localization changed, will be marked as complete.
zh-cn/guides/deploy/seenode.mdx Localization changed, will be marked as complete.
zh-cn/guides/deploy/stormkit.mdx Localization changed, will be marked as complete.
zh-cn/guides/deploy/surge.mdx Localization changed, will be marked as complete.
zh-cn/guides/deploy/vercel.mdx Localization changed, will be marked as complete.
zh-cn/guides/deploy/zeabur.mdx Localization changed, will be marked as complete.
zh-cn/guides/deploy/zerops.mdx Localization changed, will be marked as complete.
zh-tw/guides/deploy/github.mdx Localization changed, will be marked as complete.
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.

@sarah11918 sarah11918 changed the title New deploy guide navigation component [i18nIgnore] New deploy guide navigation component Nov 18, 2025
@sarah11918 sarah11918 added the site improvement Some thing that improves the website functionality - ask @delucis for help! label Nov 19, 2025
@sarah11918 sarah11918 marked this pull request as ready for review November 19, 2025 18:08
Co-authored-by: HiDeoo <494699+HiDeoo@users.noreply.github.com>
Co-authored-by: ainurx_78 <34947605+ainurx@users.noreply.github.com>
@trueberryless

This comment was marked as off-topic.

gitlab: { file: 'gitlab.svg', padding: '0' },
'google-cloud': { file: 'google-cloud.svg', padding: '.1875em' },
firebase: { file: 'firebase.svg', padding: '.1875em' },
'google-firebase': { file: 'firebase.svg', padding: '.1875em' },
Copy link
Member Author

@sarah11918 sarah11918 Nov 20, 2025

Choose a reason for hiding this comment

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

I can't tell if this is Firebase Studio being Firebase Studio... I don't think we are relying on google-firebase anymore, but I get a type error when I remove this. It's possible this is being used by the Firebase backend guide? It's possible Firebase Studio can't effectively clear a cache and update?

In an ideal world, we don't need this, and I don't know if it's just my setup or if we're still using this somewhere.

Copy link
Member

Choose a reason for hiding this comment

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

It's not a Firebase issue. Well, it is but in our docs. 😄
In BackendGuidesNav.astro, we use:

const logo = isLogoKey(page.id.split('/').pop());

And because the backend guide is still named google-firebase.mdx, we're checking if google-firebase is a valid logo key. When we remove google-firebase from src/data/logo.ts this is no longer the case.
So, either we also rename the backend file or we don't rename the logo key yet (and we would need to replace all the logo: firebase changes with logo: google-firebase).

Copy link
Member

@HiDeoo HiDeoo Nov 20, 2025

Choose a reason for hiding this comment

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

I think we may have hit that exact issue during the call and decided against renaming the icon in this PR in the end? Or am I confusing this one with another one?

Copy link
Member

Choose a reason for hiding this comment

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

Yes, this is the same issue. 😅 If I recall what we said is that updating the other types of guide was maybe out of scope for this PR? But if the issue is just renaming the file and we're fine with that, this is a quick fix I think.

Copy link
Member Author

Choose a reason for hiding this comment

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

Yeah, I think this is a good "quick fix" for now -- we have two entries, one that satisfies each type of guide. When we reconfigure back-end guides to match this setup, we can remove the extraneous google-firebase

Copy link
Member Author

Choose a reason for hiding this comment

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

@delucis Can you weigh in on whether this "hack" seems OK for the scope of this PR?

Copy link
Member Author

Choose a reason for hiding this comment

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

UPDATE: I'm updating backend guides to work the same way, so if we merge this as-is, with two entries (firebase and google-firebase) then I should immediately have another PR to merge that will update all the backend guides and will delete the duplicate google-firebase entry.

Copy link
Member

@ArmandPhilippot ArmandPhilippot left a comment

Choose a reason for hiding this comment

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

I don't see any issues to keep both firebase and google-firebase in logos, especially since the accompanying PR is ready. So, everything looks good to me, well done! 🚀

@sarah11918
Copy link
Member Author

Also noting that we will need @yanthomasdev to help with a Lunaria statement here!

I believe that the only files that should show as "changed and needing updating" are the guides where sidebar.label:

  • changed (e.g. "Deno" is now "Deno Deploy")
  • contains extra text other than the service name (e.g. AWS via SST) because we'd now like these translated

@yanthomasdev
Copy link
Member

@sarah11918 I believe this is the code we want! It's only Flightcontrol, SST, Firebase, and Deno that changed, right?

@lunaria-track:src/content/docs/en/guides/deploy/aws-via-flightcontrol.mdx;src/content/docs/en/guides/deploy/aws-via-sst.mdx;
src/content/docs/en/guides/deploy/firebase.mdx;‎src/content/docs/de/guides/deploy/deno.mdx

@ArmandPhilippot
Copy link
Member

Yes, I think these are the only ones. But I wonder if the followings should be reported as updated:

  • Firebase: this is the service name and, currently, I think every languages use Google Firebase
  • Deno Deploy: same here, it seems to be the service name, so nothing to update? (I checked a few languages and it seems no one translate "Deno Deploy" inside the guide)

So, maybe the only ones worth tracking are Flightcontrol and SST because of "via"?

But if we prefer to make sure it's okay, yes, that sounds right to me!

@sarah11918
Copy link
Member Author

I realized that the firebase.mdx file changed names, so I think maybe best to leave that one in, just in case? 😅 But agreed, as no one seems to translate "Deploy" in Deno Deploy, I'll remove that one from the statement.

@ArmandPhilippot
Copy link
Member

Ah yes, good call! I hadn't thought about the filename! Sounds good to me!

@sarah11918 sarah11918 merged commit df37d7f into main Nov 24, 2025
11 checks passed
@sarah11918 sarah11918 deleted the deploy-guides-alpha branch November 24, 2025 18:21
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

i18n Anything to do with internationalization & translation efforts - ask @YanThomas for help! site improvement Some thing that improves the website functionality - ask @delucis for help!

Projects

None yet

Development

Successfully merging this pull request may close these issues.

8 participants