Skip to main content

πŸ“‹ Changelog

June 2026​

Documentation​

  • Evaluating npm Packages β€” added a planning guide for evaluating npm dependencies before adoption
  • Playwright E2E Recipe β€” practical recipe covering Page Object Model, selector strategy, and GitHub Actions CI patterns for E2E testing
  • dotenv β€” new tech stack entry covering non-destructive .env loading, CJS/ESM usage, override: true, and comparison with Node.js --env-file, dotenv-flow, and cross-env
  • Environment Variables β€” new comprehensive guide covering .env naming conventions, build-time vs runtime distinction, Vite's import.meta.env handling, GitHub Actions secrets workflow, and production secrets management
  • Vite β€” added environment variables section covering import.meta.env and VITE_* prefix handling
  • Jest β€” added discouraged entry recommending Vitest as the default testing framework
  • Triage β€” new page listing libraries that need evaluation before adoption into the recommended stack
  • Multi-Agent Orchestration β€” added Copilot SDK as the TypeScript/Node.js agent runtime recommendation; removed Mastra from framework options
  • AI Coding Agents β€” added Copilot Automations (cloud agent) section covering scheduled/event-driven autonomous agents
  • Container Queries β€” fixed Baseline status: corrected from "Widely available since February 2023" to "Widely available since August 2025" (February 2023 was Newly available)
  • HTML Sanitizer API β€” updated to reflect redesigned API: corrected Sanitizer constructor option names and browser support versions per current MDN documentation
  • Performance & Core Web Vitals β€” fixed INP metric description: clarified it reports near-worst-case (98th percentile for 50+ interactions), not absolute worst-case
  • Package Publishing β€” complete new section covering npm publishing basics, versioning, advanced packaging patterns, GitHub Packages, private registries, and monorepo release workflows
  • Visual Regression Testing with Vitest β€” new standalone recipe (split out of Testing Strategy) covering Vitest 4 provider packages, locator-based toMatchScreenshot, baseline workflow, and CI/OS consistency caveats; Testing Strategy now carries a short summary linking the recipe
  • Publishing Your First Package to npm β€” documented the @aliz.ai npm organization as the scope for publishing Aliz packages
  • Firebase β€” new Backend Services tech stack category with Firebase as the recommended BaaS: rationale, alternatives, pricing tiers, and when-not-to-use guidance
  • Token Consumption Optimization β€” new guide covering strategies to reduce AI tool token consumption, ordered by impact: model selection, thinking effort, multi-agent model routing, context management, conversation compaction, and usage analysis; expanded subagent section with guidance on delegating file search and reading to small utility models
  • npm Workspaces β€” new learning page covering workspace setup, command targeting, cross-workspace linking, the semver-match registry fallback, and limitations vs pnpm/Yarn
  • Publishing from a Monorepo β€” corrected workspace protocol support: npm does not support the workspace: protocol (pnpm and Yarn Berry do)
  • Triage β€” added TanStack Virtual for evaluation
  • AI Assistant Chat cookbook β€” added note that TanStack Virtual is under evaluation for replacing scroll anchor flags in Zustand, with link to the chat primitives blog post
  • AI-Assisted Development β€” added LLM Wiki blog series links to Further Reading (LLM Wiki pattern, Aliz Web Hub implementation, local models, and OKF v0.1 formal spec)
  • Triage β€” added TanStack AI for evaluation
  • Triage β€” added AG-UI protocol for evaluation
  • Triage β€” restructured into folder with dedicated AI Tooling sub-section; added Vercel AI SDK and MCP Apps evaluation pages
  • MCP Servers β€” added section on the 2026-07-28 specification release candidate: stateless core redesign, MCP Apps, Tasks extension, observability headers, and deprecated features (Roots, Sampling, Logging) with July 2027 sunset
  • MCP Servers β€” added MDN Web Docs MCP Server section: remote HTTP server (https://mcp.mdn.mozilla.net/) providing mcp_mdn_search, mcp_mdn_get-doc, and mcp_mdn_get-compat tools; already configured in the project's .vscode/mcp.json
  • Security Overview β€” corrected SameSite cookie default: SameSite=Lax is the default only in Chromium-based browsers (Chrome 80+, Edge 86); Firefox and Safari do not yet default to Lax
  • HTML Sanitizer API β€” corrected experimental browser support to Chrome 146+ (was Chrome 124+)
  • URLPattern β€” corrected Safari support to Safari 26+ (was Safari 16.4+)
  • Container Queries β€” updated CSS container style queries browser support to include Safari 18+ and Firefox 151+ alongside Chrome/Edge 111+
  • Zod β€” added LLM structured output as a When to use case: constraining model responses with Zod 4's z.toJSONSchema() across OpenAI, Anthropic, and Gemini
  • Triage β€” added Pulumi (TypeScript SDK) for evaluation as an IaC solution for Node.js and frontend projects

Blog​

Infrastructure​

  • Added web-api-fact-check.instructions.md β€” Copilot instruction that enforces fact-checking Web API, CSS, and HTTP references against MDN Web Docs before publishing
  • Added instructions.instructions.md β€” guidelines for creating high-quality Copilot custom instruction files, covering required frontmatter, file structure, writing style, and maintenance practices
  • Pinned GitHub Actions to full-length commit SHAs for supply chain security (docs-build workflow)
  • Removed the leftover Docusaurus tutorial boilerplate (docs-tutorial/) from the docs sidebar
  • Removed Docusaurus scaffold blog posts and sample author entries from blog/authors.yml
  • Added .vscode/mcp.json β€” MDN MCP server configured for the repository; connects VS Code Copilot to https://mcp.mdn.mozilla.net/ for web platform documentation and compatibility lookups
  • Updated web-api-fact-check.instructions.md β€” integrated MDN MCP server tools (mcp_mdn_search, mcp_mdn_get-doc, mcp_mdn_get-compat) as the primary verification method; manual MDN URL lookups become the fallback when MCP is unavailable

May 2026​

Documentation​

  • Internal Projects β€” added docs for Emma, Vacation Dashboard, and Wiki projects
  • GitHub Actions Supply Chain Security β€” new security page covering CI/CD supply chain risks
  • npm Supply Chain Security β€” added instructions, .npmrc hardening, and min-release-age recommendation
  • Deprecated Technologies β€” documented discouraged/deprecated libraries (Moment.js β†’ Luxon migration)
  • Storybook β€” added to the tech stack
  • Browser APIs β€” new Learn section with navigator.sendBeacon and URL Pattern API pages
  • Copilot Customization Files β€” scoped instruction files, reusable prompt templates, and agent skills for shaping Copilot behavior at the repo level
  • Prompt Engineering β€” added AGENTS.md tool-agnostic convention to workspace instruction files
  • Redux Toolkit / RTK Query β€” moved to new Advanced / Situational subcategory
  • Legacy Redux β€” updated to distinguish legacy patterns from modern Redux Toolkit
  • React Hook Form β€” new page covering React Hook Form as an advanced form management option, with TanStack Form comparison
  • Forms β€” new guide comparing form handling approaches (native, server actions, manual React, library-based)
  • Rendering Architectures β€” split from top-level Rendering page; detailed descriptions of SPA, SSR, SSG, and Islands
  • Choosing a Rendering Architecture β€” new planning guide for selecting the right rendering strategy
  • Sidebar reorganization β€” moved Performance into Learn, created Testing section, created Infrastructure section
  • Prompt Engineering β€” added model selection, vision/image context, Next Edit Suggestions, test generation and code review instruction settings
  • Copilot Customization Files β€” added custom chat modes (.chatmode.md) and Copilot Extensions sections
  • AI Coding Guidelines β€” added content exclusions section under security considerations
  • ESLint β€” added as recommended linter in tech stack
  • Prettier β€” added as recommended formatter in tech stack
  • VisX β€” added as Advanced / Situational data visualization option
  • D3.js β€” added as Advanced / Situational data visualization option
  • Testing Strategy β€” added code coverage section: Vitest LCOV generation, GitHub native coverage upload, and ruleset enforcement
  • Web Platform Baseline β€” new page explaining Baseline tiers, core browser set, tooling integration, and decision guidance

Blog​

Infrastructure​

  • Agentic daily documentation updater workflow (switched from Claude to Copilot)
  • GitHub Actions lock file and maintenance workflow
  • Changelog instructions and initial changelog (web-hub-website/docs/changelog.md)

April 2026​

Documentation​

  • AI-Assisted Development β€” complete new section covering the full spectrum from autocomplete to multi-agent pipelines, including agent skills, prompt engineering, MCP servers, and vibe coding
  • UI/UX Design β€” new section with laws of UX, visual design, accessibility, UI patterns, and design tools
  • Security β€” added section with prototype pollution docs and OWASP-based npm security checklist
  • Performance & Core Web Vitals β€” new performance documentation with Lighthouse CI guidance
  • Workbox β€” added service worker tooling to tech stack
  • Cross-references β€” improved page discoverability by linking orphan pages

Blog​

March 2026​

Documentation​

  • Tech Stack β€” the curated set of recommended tools for Aliz frontend projects, covering Build & Dev (Vite, Vitest, Playwright), Core (React, TypeScript), Data Visualization (Recharts, ECharts), State & Data (TanStack Query), and Styling & UI (Tailwind CSS, shadcn/ui, MUI)
  • Rendering β€” architecture strategies and trade-offs (SSR, SSG, CSR, ISR)
  • Testing β€” three-layer testing strategy (unit, visual regression, E2E) with Vitest and Playwright coverage
  • Requirement Engineering β€” expanded with B2B/B2C considerations, browser support, i18n, accessibility, and performance metrics
  • Estimation β€” new Cookbooks section with React SPA recipe and complexity factors reference
  • Recruitment β€” added Senior Web/React Developer recruiter guide and interview questions
  • Deployment β€” extended deployment documentation
  • npm β€” added to tech stack, updated pnpm recommendation to npm default
  • i18next β€” internationalization support documentation
  • Math support β€” added KaTeX rendering via remark-math and rehype-katex

Blog​

Infrastructure​

  • GitHub Actions CI workflow for builds
  • Google Analytics integration
  • Dependency updates (Node.js >=18, Firebase 10.x)

May–June 2023​

Documentation​

  • First blog posts and tutorial content

Infrastructure​

  • Docusaurus site scaffolding and initial deployment
  • Firebase authentication setup
  • Algolia search integration
  • Deployment under aliz-ai subdomain