chore: align repository docs and CI with Aliyun hosting

.env.example

@@ -1,33 +1,8 @@
-# visit https://giscus.app to get your Giscus ids
+# Optional: GitHub Discussions comments through Giscus.
 NEXT_PUBLIC_GISCUS_REPO=
 NEXT_PUBLIC_GISCUS_REPOSITORY_ID=
 NEXT_PUBLIC_GISCUS_CATEGORY=
 NEXT_PUBLIC_GISCUS_CATEGORY_ID=
-NEXT_PUBLIC_UTTERANCES_REPO=
-NEXT_PUBLIC_DISQUS_SHORTNAME=
 
-
-MAILCHIMP_API_KEY=
-MAILCHIMP_API_SERVER=
-MAILCHIMP_AUDIENCE_ID=
-
-BUTTONDOWN_API_KEY=
-
-CONVERTKIT_API_KEY=
-# curl https://api.convertkit.com/v3/forms?api_key=<your_public_api_key> to get your form ID
-CONVERTKIT_FORM_ID=
-
-KLAVIYO_API_KEY=
-KLAVIYO_LIST_ID=
-
-REVUE_API_KEY=
-
-# Create EmailOctopus API key at https://emailoctopus.com/api-documentation
-EMAILOCTOPUS_API_KEY=
-# List ID can be found in the URL as a UUID after clicking a list on https://emailoctopus.com/lists
-# or the settings page of your list https://emailoctopus.com/lists/{UUID}/settings
-EMAILOCTOPUS_LIST_ID=
-
-# Create Beehive API key at https://developers.beehiiv.com/docs/v2/bktd9a7mxo67n-create-an-api-key
-BEEHIVE_API_KEY=
-BEEHIVE_PUBLICATION_ID=
+# Optional: Umami analytics site ID.
+NEXT_UMAMI_ID=

.github/ISSUE_TEMPLATE/bug_report.md

@@ -26,8 +26,8 @@ If applicable, add screenshots to help explain your problem.
 **System Info (if dev / build issue):**
 
 - OS: [e.g. iOS]
-- Node version (please ensure you are using 18+)
-- Npm version
+- Node version (see `.nvmrc`)
+- Yarn version (see `package.json`)
 
 **Browser Info (if display / formatting issue):**
 

.github/workflows/ci.yml

@@ -0,0 +1,26 @@
+name: Build and test
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+      - uses: actions/setup-node@v7
+        with:
+          node-version-file: .nvmrc
+      - run: node .yarn/releases/yarn-3.6.1.cjs install --immutable
+      - run: node .yarn/releases/yarn-3.6.1.cjs build
+        env:
+          EXPORT: '1'
+          UNOPTIMIZED: '1'
+      - run: node .yarn/releases/yarn-3.6.1.cjs test

.gitignore

@@ -15,6 +15,7 @@
 # next.js
 /.next/
 /out/
+tsconfig.tsbuildinfo
 public/sitemap.xml
 .vercel
 

package.json

@@ -1,11 +1,11 @@
 {
-  "name": "tailwind-nextjs-starter-blog",
-  "version": "2.3.0",
+  "name": "apframework-site",
   "private": true,
   "scripts": {
     "start": "next dev",
     "dev": "cross-env INIT_CWD=$PWD next dev",
     "build": "cross-env INIT_CWD=$PWD next build && cross-env NODE_OPTIONS='--experimental-json-modules' node ./scripts/postbuild.mjs",
+    "test": "node --test tests/*.test.mjs",
     "serve": "next start",
     "analyze": "cross-env ANALYZE=true next build",
     "lint": "next lint --fix --dir pages --dir app --dir components --dir lib --dir layouts --dir scripts",
@@ -16,7 +16,6 @@
     "@emotion/is-prop-valid": "^1.4.0",
     "@headlessui/react": "2.2.0",
     "@next/bundle-analyzer": "15.0.2",
-    "@next/swc-darwin-x64": "^15.2.4",
     "@nextui-org/react": "latest",
     "@tailwindcss/forms": "^0.5.9",
     "@tailwindcss/typography": "^0.5.15",

tests/seo-output.test.mjs

@@ -74,7 +74,7 @@ test('BlogPosting identifies the public article, author, and an absolute image',
   assert.equal(article.url, `${siteUrl}${route}`)
   assert.equal(
     article.image,
-    `${siteUrl}/static/images/2026-10-25-agent-architecture-evolution/diogo-ferrer-9pqqV6YqTK0-unsplash.jpg`
+    `${siteUrl}/static/images/2026-10-25-agent-architecture-evolution/social-card.png`
   )
   assert.equal(article.author?.[0]?.url, `${siteUrl}/about`)
 })

yarn.lock

@@ -3163,14 +3163,6 @@ __metadata:
   languageName: node
   linkType: hard
 
-"@next/swc-darwin-x64@npm:^15.2.4":
-  version: 15.5.7
-  resolution: "@next/swc-darwin-x64@npm:15.5.7"
-  checksum: d43c4fc509731f0d11a504cf6241c75f7e11e6a73496289943bf428e478846f08ea81cce13e6a00bcea44a7271c624cb42f5f5087d8dbd3c776f4ece86b468e9
-  conditions: os=darwin & cpu=x64
-  languageName: node
-  linkType: hard
-
 "@next/swc-linux-arm64-gnu@npm:15.0.2":
   version: 15.0.2
   resolution: "@next/swc-linux-arm64-gnu@npm:15.0.2"
@@ -8210,6 +8202,66 @@ __metadata:
   languageName: node
   linkType: hard
 
+"apframework-site@workspace:.":
+  version: 0.0.0-use.local
+  resolution: "apframework-site@workspace:."
+  dependencies:
+    "@antv/infographic": ^0.2.10
+    "@emotion/is-prop-valid": ^1.4.0
+    "@headlessui/react": 2.2.0
+    "@next/bundle-analyzer": 15.0.2
+    "@nextui-org/react": latest
+    "@svgr/webpack": ^8.0.1
+    "@tailwindcss/forms": ^0.5.9
+    "@tailwindcss/typography": ^0.5.15
+    "@types/mdx": ^2.0.12
+    "@types/react": ^18.2.73
+    "@typescript-eslint/eslint-plugin": ^8.12.0
+    "@typescript-eslint/parser": ^8.12.0
+    autoprefixer: ^10.4.13
+    body-scroll-lock: ^4.0.0-beta.0
+    contentlayer2: 0.5.3
+    cross-env: ^7.0.3
+    esbuild: 0.20.2
+    eslint: ^9.14.0
+    eslint-config-next: 15.0.2
+    eslint-config-prettier: ^9.1.0
+    eslint-plugin-prettier: ^5.2.0
+    framer-motion: ^11.12.0
+    github-slugger: ^2.0.0
+    gray-matter: ^4.0.2
+    hast-util-from-html-isomorphic: ^2.0.0
+    husky: ^9.1.7
+    image-size: 1.0.0
+    lint-staged: ^13.0.0
+    mermaid: ^11.12.2
+    next: 15.0.2
+    next-contentlayer2: 0.5.3
+    next-themes: ^0.3.0
+    pliny: 0.4.0
+    postcss: ^8.4.24
+    prettier: ^3.0.0
+    prettier-plugin-tailwindcss: ^0.5.11
+    react: ^18.2.0
+    react-dom: ^18.2.0
+    reading-time: 1.5.0
+    rehype-autolink-headings: ^7.1.0
+    rehype-citation: ^2.0.0
+    rehype-katex: ^7.0.0
+    rehype-katex-notranslate: ^1.1.4
+    rehype-preset-minify: 7.0.0
+    rehype-prism-plus: ^2.0.0
+    rehype-slug: ^6.0.0
+    remark: ^15.0.0
+    remark-gfm: ^4.0.0
+    remark-github-blockquote-alert: ^1.2.1
+    remark-math: ^6.0.0
+    tailwindcss: ^3.4.14
+    typescript: ^5.1.3
+    unist-util-visit: ^5.0.0
+  languageName: unknown
+  linkType: soft
+
 "arg@npm:^5.0.2":
   version: 5.0.2
   resolution: "arg@npm:5.0.2"
@@ -16777,67 +16829,6 @@ __metadata:
   languageName: node
   linkType: hard
 
-"tailwind-nextjs-starter-blog@workspace:.":
-  version: 0.0.0-use.local
-  resolution: "tailwind-nextjs-starter-blog@workspace:."
-  dependencies:
-    "@antv/infographic": ^0.2.10
-    "@emotion/is-prop-valid": ^1.4.0
-    "@headlessui/react": 2.2.0
-    "@next/bundle-analyzer": 15.0.2
-    "@next/swc-darwin-x64": ^15.2.4
-    "@nextui-org/react": latest
-    "@svgr/webpack": ^8.0.1
-    "@tailwindcss/forms": ^0.5.9
-    "@tailwindcss/typography": ^0.5.15
-    "@types/mdx": ^2.0.12
-    "@types/react": ^18.2.73
-    "@typescript-eslint/eslint-plugin": ^8.12.0
-    "@typescript-eslint/parser": ^8.12.0
-    autoprefixer: ^10.4.13
-    body-scroll-lock: ^4.0.0-beta.0
-    contentlayer2: 0.5.3
-    cross-env: ^7.0.3
-    esbuild: 0.20.2
-    eslint: ^9.14.0
-    eslint-config-next: 15.0.2
-    eslint-config-prettier: ^9.1.0
-    eslint-plugin-prettier: ^5.2.0
-    framer-motion: ^11.12.0
-    github-slugger: ^2.0.0
-    gray-matter: ^4.0.2
-    hast-util-from-html-isomorphic: ^2.0.0
-    husky: ^9.1.7
-    image-size: 1.0.0
-    lint-staged: ^13.0.0
-    mermaid: ^11.12.2
-    next: 15.0.2
-    next-contentlayer2: 0.5.3
-    next-themes: ^0.3.0
-    pliny: 0.4.0
-    postcss: ^8.4.24
-    prettier: ^3.0.0
-    prettier-plugin-tailwindcss: ^0.5.11
-    react: ^18.2.0
-    react-dom: ^18.2.0
-    reading-time: 1.5.0
-    rehype-autolink-headings: ^7.1.0
-    rehype-citation: ^2.0.0
-    rehype-katex: ^7.0.0
-    rehype-katex-notranslate: ^1.1.4
-    rehype-preset-minify: 7.0.0
-    rehype-prism-plus: ^2.0.0
-    rehype-slug: ^6.0.0
-    remark: ^15.0.0
-    remark-gfm: ^4.0.0
-    remark-github-blockquote-alert: ^1.2.1
-    remark-math: ^6.0.0
-    tailwindcss: ^3.4.14
-    typescript: ^5.1.3
-    unist-util-visit: ^5.0.0
-  languageName: unknown
-  linkType: soft
-
 "tailwind-variants@npm:^0.1.20":
   version: 0.1.20
   resolution: "tailwind-variants@npm:0.1.20"