WIP: Migrate pharos site to astro

.gitignore

@@ -7,9 +7,18 @@ dist/
 .storybook-static/
 coverage/
 lib/
+# `lib/` above targets compiled build output, but is unanchored, so it also
+# swallowed the Astro site's hand-written src/lib/ — leaving that source
+# untracked and the package unbuildable from a fresh clone.
+!packages/pharos-site-astro/src/lib/
 packages/**/package-lock.json
 packages/pharos-site/public/
 packages/pharos-site/.cache/
+packages/pharos-site-astro/.astro/
+# Brand-asset archives carried over from the Gatsby site's static/ directory.
+# Nothing in the source or the built HTML links to them, so they are kept out of
+# git history here rather than duplicating the ~7.4MB the Gatsby package tracks.
+packages/pharos-site-astro/public/files/**/*.zip
 react-components/
 packages/pharos/src/styles/**/*.ts
 packages/pharos/src/styles/_variables.scss

.prettierignore

@@ -9,6 +9,19 @@ packages/pharos/custom-elements.json
 packages/**/package-lock.json
 packages/pharos-site/public/
 packages/pharos-site/.cache/
+packages/pharos-site-astro/.astro/
+# Prettier is not safe on any MDX in this package. It rewrites MDX comment
+# delimiters ({/* */} -> {/_ _/}), which produces invalid JSX and fails the
+# build outright, and it reflows elements such as <li>/<dd>/<code> onto several
+# lines. MDX treats a tag whose content spans multiple lines as Markdown and
+# wraps it in a generated <p>, so a purely cosmetic reflow silently adds
+# paragraph margins to the rendered page.
+#
+# This must match src/** and not just src/pages/**: the component pages moved
+# to src/content/ in the collection refactor, and a src/pages-only glob left
+# all 32 of them unprotected. {/* prettier-ignore */} is not an alternative --
+# prettier corrupts the marker's own delimiters before it can take effect.
+packages/pharos-site-astro/src/**/*.mdx
 package.json
 package-lock.json
 .changeset/

.prettierrc.js

@@ -1,4 +1,7 @@
 module.exports = {
+  // `.astro` has no built-in parser; without this prettier reports
+  // "No parser could be inferred" and silently formats none of them.
+  plugins: ['prettier-plugin-astro'],
   printWidth: 100,
   trailingComma: 'es5',
   tabWidth: 2,

build-ignore.sh

@@ -12,5 +12,5 @@ then
   git diff --quiet $CACHED_COMMIT_REF $COMMIT_REF packages/pharos/ .storybook/ package.json yarn.lock netlify.toml
 elif [ "$SITE_NAME" == "pharos" ]
 then
-  git diff --quiet $CACHED_COMMIT_REF $COMMIT_REF packages/pharos-site/ package.json yarn.lock netlify.toml
+  git diff --quiet $CACHED_COMMIT_REF $COMMIT_REF packages/pharos/ packages/pharos-site-astro/ package.json yarn.lock netlify.toml
 fi

eslint.config.mjs

@@ -1,4 +1,5 @@
 import js from '@eslint/js';
+import astroPlugin from 'eslint-plugin-astro';
 import reactPlugin from 'eslint-plugin-react';
 import prettierPlugin from 'eslint-plugin-prettier';
 import storybookPlugin from 'eslint-plugin-storybook';
@@ -12,6 +13,7 @@ const globalIgnores = [
   'packages/pharos/src/styles/**/*.ts',
   'packages/pharos-site/public/',
   'packages/pharos-site/.cache/',
+  'packages/pharos-site-astro/.astro/',
   '**/dist/',
   '**/node_modules/',
   '**/*.css.ts',
@@ -84,10 +86,30 @@ const tsxConfig = {
   },
 };
 
+const astroConfig = [
+  ...astroPlugin.configs.recommended,
+  ...astroPlugin.configs['jsx-a11y-recommended'],
+  {
+    files: ['**/*.astro'],
+    plugins: {
+      '@typescript-eslint': typeScriptEsLint,
+    },
+    rules: {
+      // TypeScript resolves identifiers itself, and `no-undef` cannot see
+      // type-only names, so it only fires falsely in frontmatter.
+      'no-undef': 'off',
+      'no-unused-vars': 'off',
+      '@typescript-eslint/no-unused-vars': ['error'],
+      '@typescript-eslint/no-explicit-any': ['error'],
+    },
+  },
+];
+
 export default [
   { ignores: globalIgnores },
   js.configs.recommended,
   pharosConfig,
   tsConfig,
   tsxConfig,
+  ...astroConfig,
 ];

lint-staged.config.js

@@ -1,6 +1,7 @@
 module.exports = {
   'packages/pharos/assets/icons/*.svg': [`svglint --ci`],
   '*.{ts,tsx,js,mjs}': ['eslint --fix'],
+  '*.astro': ['eslint --fix'],
   '*.{scss,css}': ['stylelint --fix'],
   '**/!(.changeset)/*.md': (filenames) =>
     filenames.map((filename) => `yarn markdown-toc -i '${filename}'`),

netlify.toml

@@ -1,3 +1,11 @@
+[build]
+  command = "yarn site-astro:build"
+  publish = "packages/pharos-site-astro/dist"
+  ignore = "bash ./build-ignore.sh"
+
+[build.environment]
+  NODE_VERSION = "24"
+
 [[redirects]]
   from = "/storybook"
   to = "https://pharos-storybooks.netlify.app/main/"
@@ -39,6 +47,3 @@
     [headers.values]
     Access-Control-Allow-Origin = "*"
     X-Frame-Options = "SAMEORIGIN"
-
-[build]
-  ignore = "bash ./build-ignore.sh"

package.json

@@ -7,8 +7,9 @@
     "build:tokens": "yarn workspace @ithaka/pharos build:tokens",
     "analyze": "yarn workspace @ithaka/pharos analyze",
     "format": "prettier packages/* --write",
-    "lint": "yarn lint:lit-analyzer && yarn lint:eslint && yarn lint:styles && yarn lint:icons",
-    "lint:eslint": "eslint 'packages/**/*.{ts,tsx,js,jsx,mjs}'",
+    "lint": "yarn lint:lit-analyzer && yarn lint:eslint && yarn lint:styles && yarn lint:icons && yarn lint:astro",
+    "lint:astro": "yarn workspace @ithaka/pharos-site-astro check",
+    "lint:eslint": "eslint 'packages/**/*.{ts,tsx,js,jsx,mjs,astro}'",
     "lint:lit-analyzer": "lit-analyzer 'packages/*/src/**/!(*.css|*.test).ts' --strict --rules.no-missing-import off --rules.no-unknown-tag-name off",
     "lint:styles": "stylelint 'packages/**/*.{scss,css}'",
     "lint:icons": "svglint --ci packages/pharos/assets/icons/*.svg",
@@ -42,6 +43,13 @@
     "site:develop": "yarn presite:develop && yarn workspace @ithaka/pharos-site develop",
     "site:serve": "yarn workspace @ithaka/pharos-site serve",
     "site:clean": "yarn workspace @ithaka/pharos-site clean",
+    "presite-astro:build": "yarn build:core",
+    "site-astro:build": "yarn presite-astro:build && yarn workspace @ithaka/pharos-site-astro build",
+    "presite-astro:develop": "yarn build:core",
+    "site-astro:develop": "yarn presite-astro:develop && yarn workspace @ithaka/pharos-site-astro develop",
+    "site-astro:serve": "yarn workspace @ithaka/pharos-site-astro preview",
+    "site-astro:check": "yarn workspace @ithaka/pharos-site-astro check",
+    "site-astro:clean": "yarn workspace @ithaka/pharos-site-astro clean",
     "release": "changeset publish",
     "prepare": "husky install"
   },
@@ -80,10 +88,12 @@
     "@typescript-eslint/parser": "^8.67.0",
     "@vitejs/plugin-react": "^6.1.0",
     "all-contributors-cli": "^6.26.1",
+    "astro-eslint-parser": "^3.1.0",
     "concurrently": "^10.0.5",
     "cssnano": "^8.0.7",
     "eslint": "^10.9.0",
     "eslint-config-prettier": "^10.1.8",
+    "eslint-plugin-astro": "^3.1.0",
     "eslint-plugin-jsx-a11y": "^6.10.2",
     "eslint-plugin-lit": "^2.3.1",
     "eslint-plugin-prettier": "^5.5.6",
@@ -102,6 +112,7 @@
     "postcss-media-minmax": "^5.0.0",
     "postcss-preset-env": "^11.4.0",
     "prettier": "^3.9.6",
+    "prettier-plugin-astro": "0.14.1",
     "pretty-quick": "^4.2.2",
     "react": "^18.3.1",
     "react-dom": "^18.3.1",
@@ -113,6 +124,7 @@
     "stylelint-scss": "^7.2.0",
     "svglint": "^4.2.1",
     "typescript": "^6.0.3",
+    "typescript-eslint": "^8.65.0",
     "vite": "^8.2.2"
   },
   "resolutions": {