Skip to content

feat: move the site to @deramond.dev/astro, dropping Starlight - #1686

Merged
julien-deramond merged 4 commits into
mainfrom
site-on-deramond-astro
Sep 24, 2026
Merged

julien-deramond merged 4 commits into
mainfrom
site-on-deramond-astro

Conversation

@julien-deramond

Copy link
Copy Markdown
Member

Moves openresource.dev from Starlight and starlight-blog to plain Astro with @deramond.dev/astro 0.4.0. One dark theme, and the {re} mark redrawn flat in one colour.

Every URL is kept

  • Guide and resources are docs at the site root: /guide/… and /resources/… are unchanged. The sidebar keeps its order in nine numbered groups: Guide, the seven modules, Resources. Each module's index is its "Introduction". "Edit on GitHub" and edited dates stay.
  • Articles are the blog at /articles/: a featured post, tag pages at the same /articles/tags/<tag>/ slugs, and /articles/rss.xml. /rss.xml still redirects to it. Every article carries schema.org BlogPosting data, as before.
  • Home, showcase, about the author and cookie policy are the site's own pages.
  • OG images keep their paths (/og/guide/….png, /og/articles/….png).
  • The author page /articles/authors/julien-déramond/ now redirects to /articles/. It's the only live URL that isn't built as a page.

All 86 URLs in the live sitemap were checked against the build.

What changed

  • Content: the 28 :::note / :::tip / :::caution asides are now GitHub-style alerts (> [!NOTE], [!TIP], [!WARNING]), titles kept. Badge and Steps come from the package. Articles name authors: julien explicitly, and the module index pages have label: Introduction.
  • Components: Chat, showcase cards, the showcase banner and the guide's reading time are restyled on the design tokens. starlight-showcases is replaced by a small ShowcaseEntry card.
  • Homepage: the hero, then the seven guide modules, the latest three articles, the showcase banner and "Support us". The module and article sections only list existing content.
  • Head tags: twitter:site and fediverse:creator are kept through the integration's head option.
  • Favicons and web manifest come from src/brand/favicons/. The old files in public/ are removed.
  • README: one header image with its own dark background, replacing the light/dark pair. A licence note says the mark and artwork are not under CC BY-NC-SA.
  • Dependencies: Astro 7.3.5. @astrojs/mdx and @astrojs/sitemap are added, because Starlight used to bundle them. Removed: @astrojs/starlight, starlight-blog, starlight-links-validator, starlight-showcases, astro-og-canvas, reading-time and @astrojs/markdown-remark.
  • Server output on Vercel is unchanged. Every page is prerendered, and the site's own pages declare it.

Dropped

  • Link validation (starlight-links-validator): the build no longer checks internal links.
  • The reading progress bar on guide and article pages.
  • The "Coming soon" sidebar badges. Those pages keep their warning callout.
  • The support box above the page navigation. The licence is in the footer and on every article, and "Edit on GitHub" stays.
  • Cookie policy: rewritten to stay accurate. With one theme, the site no longer stores anything in local storage.

Checks

  • npm run build (astro check: 0 errors; 86 pages, OG cards, Pagefind index)
  • npm test: 17/17
  • npm run prettier:check: clean
  • At 375 px, every page fits without horizontal scroll.

🤖 Generated with Claude Code

julien-deramond and others added 2 commits September 24, 2026 13:05
The site now runs on @deramond.dev/astro 0.4.0 instead of Starlight and
starlight-blog: one dark theme, the Open {re}Source mark redrawn flat, and
every existing URL kept (guide, resources, articles, tags, RSS, OG images).

- Guide and resources: docs at the site root, same sidebar order, "Edit
  on GitHub" and edited dates.
- Articles: the blog at /articles/, tag pages, /articles/rss.xml, and
  schema.org BlogPosting data on every article.
- Home, showcase, about and cookie policy: pages of the site's own.
- Asides become GitHub-style alerts; Badge and Steps come from the
  package; Chat, showcase cards and reading time restyled.
- Favicons and the web manifest come from src/brand/favicons/.
- README header replaced by one image that carries its own dark field.

package-lock.json is refreshed once @deramond.dev/astro 0.4.0 is on npm.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@vercel

vercel Bot commented Sep 24, 2026 •

Copy link
Copy Markdown

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

Project Deployment Actions Updated
openresource-dev Ready Ready Preview Sep 24, 2026 11:51am UTC

@julien-deramond

Copy link
Copy Markdown
Member Author

Images: a new homepage image, module icons, article covers and redrawn Resources banners are being prepared; they will land here as one more commit.

- Homepage image: braces around a contribution heatmap, replacing the
  generic tiles (also the README header and the OG card art).
- Guide module cards on the homepage get one icon each.
- Every article gets a cover (public/covers/), shown on the homepage,
  the articles index and its OG card.
- Resource banners redrawn as line drawings on the dark field; Podcasts,
  which had none, gets one.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@julien-deramond

Copy link
Copy Markdown
Member Author

New artwork in aa0b031:

  • Homepage image: braces around a contribution heatmap (cyan ramp, one gold day: the first contribution), replacing the generic tiles. Same picture family in the README header and the OG card art.
  • Guide cards on the homepage: one icon per module instead of the default quarter disc.
  • Article covers: 12 SVGs in public/covers/, one per article (cover: /covers/<slug>.svg), shown on the homepage, the articles index and each article's OG card. They are URLs rather than imported images so the OG cards can read them.
  • Resources: the four violet banners are replaced by line drawings on the dark field (src/assets/resources/*.svg), and Podcasts gets one.
  • README: the "all rights reserved" note now names src/assets/resources and public/covers too.

npm run build (0 errors, 86 pages), tests 17/17, prettier clean; every changed page fits at 375 px.

"Your platform for sharing and discovering the open source world" took
five lines of display type in the hero. The homepage, the site
description, the OG card, the README header and the README intro now
say "Open source, {re}explained." with the subline "How it works, how to
contribute, how to run your own project."

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@julien-deramond

Copy link
Copy Markdown
Member Author

New headline in 8997653: Open source, {re}explained. with the subline How it works, how to contribute, how to run your own project.

  • Homepage hero: two lines instead of five, {re} in cyan.
  • Site description, the site OG card (headline with {re}explained. in cyan), README header image and README intro.

Build 0 errors, tests 17/17, prettier clean.

@julien-deramond
julien-deramond merged commit 7b48b01 into main Sep 24, 2026
4 checks passed
@julien-deramond
julien-deramond deleted the site-on-deramond-astro branch September 24, 2026 11:55

This branch was successfully deployed

1 active deployment
Preview — 89976537 Deployed Sep 24, 2026 by vercel[bot]
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