feat: IoT Hub pages (/iot-hub/)

CLAUDE.md

@@ -50,7 +50,24 @@ All documentation lives in `src/content/docs/{lang}/` as `.mdx` files with YAML
 
 ### Path Alias
 
-`~/*` maps to `./src/*` (configured in tsconfig.json).
+**Always use the `@`-prefixed path aliases for local imports** — never relative paths (`../../`) and never the legacy `~/*` alias for new code. Aliases are configured in `tsconfig.json`:
+
+| Alias | Maps to |
+|-------|---------|
+| `@models/*` | `src/models/*` |
+| `@components/*` | `src/components/*` |
+| `@layouts/*` | `src/layouts/*` |
+| `@styles/*` | `src/styles/*` |
+| `@data/*` | `src/data/*` |
+| `@util/*` | `src/util/*` |
+| `@includes/*` | `src/content/_includes/*` |
+| `@root/*` | `src/*` (catch-all for paths without a dedicated alias, e.g. `@root/consts`, `@root/pages/...`) |
+
+Prefer the most specific alias whenever one matches the target folder; fall back to `@root/*` only for `src/` paths no other alias covers.
+
+Example: `import { foo } from '@util/fetch-utils';` (not `~/util/fetch-utils` or `../../util/fetch-utils`).
+
+`~/*` (maps to `./src/*`) still exists for legacy code, but always prefer an `@` alias. SCSS `@use`/`@import` use **relative paths** (e.g., `@use '../../styles/_variables.scss' as *;`); inside `src/styles/` use sibling imports like `@use 'variables' as *;`.
 
 ### Starlight Customization
 
@@ -259,6 +276,7 @@ Use the `release` skill for the full checklist. Key files:
 - Tabs for indentation in code files; spaces for JSON, Markdown, MDX, YAML, TOML
 - Prettier with `prettier-plugin-astro`, printWidth 100, single quotes, trailing commas
 - ESLint flat config with TypeScript and Astro plugins
+- **No Figma references in comments.** Don't write "Figma", "Figma node 1234:5678", or any tool-specific node IDs in source comments — they're meaningless to anyone without access to the Figma file and rot fast. Refer to the visual spec as "the design" (or "per the design", "matches the design") and describe what's actually being implemented (sizes, colors, behaviors) so the comment stands on its own.
 
 ## CI Checks
 

astro.config.ts

@@ -41,7 +41,6 @@ export default defineConfig({
     vite: {
         resolve: {
             alias: {
-                '~': fileURLToPath(new URL('./src', import.meta.url)),
                 '@starlight/icons': fileURLToPath(
                     new URL('./node_modules/@astrojs/starlight/components-internals/Icons.ts', import.meta.url)
                 ),
@@ -53,23 +52,6 @@ export default defineConfig({
                 ),
             },
         },
-        css: {
-            preprocessorOptions: {
-                scss: {
-                    importers: [
-                        {
-                            findFileUrl(url: string) {
-                                if (!url.startsWith('~/')) return null;
-                                return new URL(
-                                    url.slice(2),
-                                    new URL('./src/', import.meta.url)
-                                );
-                            },
-                        },
-                    ],
-                },
-            },
-        },
         optimizeDeps: {
             include: ['photoswipe', 'photoswipe/lightbox'],
         },

package.json

@@ -35,7 +35,7 @@
     "@types/hast": "^3.0.4",
     "@types/node": "^24.12.2",
     "@typescript-eslint/parser": "^8.59.1",
-    "astro": "^6.1.9",
+    "astro": "^6.3.8",
     "astro-eslint-parser": "^1.4.0",
     "astro-icon": "^1.1.5",
     "dedent-js": "^1.0.1",
@@ -61,11 +61,13 @@
     "vite-plugin-svgo": "^2.0.0"
   },
   "dependencies": {
-    "@astrojs/check": "^0.9.8",
+    "@astrojs/check": "^0.9.9",
+    "@astrojs/markdown-remark": "^7.1.2",
     "@astrojs/rss": "4.0.18",
-    "@astrojs/sitemap": "^3.7.2",
-    "@astrojs/starlight": "^0.38.4",
+    "@astrojs/sitemap": "^3.7.3",
+    "@astrojs/starlight": "^0.39.2",
     "@expressive-code/plugin-collapsible-sections": "^0.41.7",
+    "@fontsource/material-icons": "^5.2.7",
     "@lunariajs/core": "^0.1.1",
     "canvas-confetti": "^1.9.4",
     "photoswipe": "^5.4.4",