feat: /releases page (#1608)

Author: yash-atreya

CLAUDE.md

@@ -0,0 +1,62 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Project Overview
+
+This is the official documentation website for Foundry, a smart contract development toolchain for Ethereum. The documentation is built using Vocs (a React-based documentation framework) and deployed to Cloudflare Pages.
+
+## Essential Commands
+
+### Development
+```bash
+cd vocs
+bun install          # Install dependencies
+bun dev             # Start development server (default: http://localhost:5173)
+bun build           # Build documentation for production
+bun preview         # Preview production build locally
+bun check-links     # Validate all internal documentation links
+```
+
+### Generating CLI Output
+```bash
+# From project root - generates auto-generated CLI command outputs
+./scripts/gen_output.sh    # Requires Foundry tools (forge, cast, anvil, chisel) installed
+```
+
+## Architecture & Structure
+
+### Key Directories
+- `/vocs/` - Main documentation source directory
+  - `/docs/pages/` - All documentation content in MDX format, organized by tool:
+    - `/forge/` - Smart contract compilation and testing documentation
+    - `/cast/` - Ethereum RPC client documentation
+    - `/anvil/` - Local Ethereum node documentation
+    - `/chisel/` - Solidity REPL documentation
+  - `/docs/public/` - Static assets (images, diagrams)
+  - `/sidebar/` - Navigation configuration (sidebar.ts and modular sections)
+  - `/docs/snippets/` - Code examples and auto-generated outputs
+
+### Configuration Files
+- `vocs/vocs.config.ts` - Main Vocs configuration (theme, navigation, sponsors)
+- `vocs/sidebar/sidebar.ts` - Main sidebar navigation structure
+- `vocs/package.json` - Dependencies and scripts
+
+### Documentation Patterns
+- MDX files support frontmatter for metadata
+- Code snippets are pulled from `/docs/snippets/projects/` test projects
+- Auto-generated CLI outputs stored in `/docs/snippets/output/`
+- Images and assets organized by topic in `/docs/public/`
+
+## Contributing Guidelines
+
+When adding or modifying documentation:
+1. Chapters start with second-level headings (`##`)
+2. Use "we" not "I" in documentation
+3. Use auto-generated CLI output where possible (run `./scripts/gen_output.sh`)
+4. Include source files from the projects folder rather than inline code
+5. Run `bun check-links` before committing to ensure all links are valid
+
+## Deployment
+
+The documentation automatically deploys to Cloudflare Pages via GitHub Actions on push to the main branch. The deployment workflow handles building and publishing to the "foundry-book" Cloudflare Pages project.

vocs/bun.lockb

@@ -0,0 +1,19 @@
+---
+title: Foundry Nightly Release
+description: Latest nightly release notes for Foundry
+---
+
+# Nightly (2025-07-23) [July 23, 2025]
+
+
+## Other
+
+- feat: use signatures identifier for --print-traces ([#11070](https://github.com/foundry-rs/foundry/pull/11070)) by [@mattsse](https://github.com/mattsse)
+- feat: use alloy-evm apply overrides ([#11071](https://github.com/foundry-rs/foundry/pull/11071)) by [@mattsse](https://github.com/mattsse)
+
+## Full Changelog:
+ https://github.com/foundry-rs/foundry/compare/nightly...nightly-cb8f3bf2c4047f17310b84a685fcc12b61c98891
+
+---
+
+*This page is automatically updated with the latest release information from the [Foundry GitHub repository](https://github.com/foundry-rs/foundry/releases).*

vocs/docs/pages/releases.mdx

@@ -0,0 +1,6 @@
+---
+title: Foundry Stable Release
+description: Latest stable release notes for Foundry
+---
+
+*This page is automatically updated with the latest release information from the [Foundry GitHub repository](https://github.com/foundry-rs/foundry/releases).*

vocs/docs/pages/releases/nightly.mdx

@@ -5,9 +5,10 @@
   "type": "module",
   "scripts": {
     "dev": "vocs dev",
-    "build": "vocs build",
-    "preview": "vocs preview",
-    "check-links": "bun check-links.ts"
+    "build": "bun run fetch-releases && vocs build",
+    "preview": "bun run build && vocs preview",
+    "check-links": "bun check-links.ts",
+    "fetch-releases": "bun scripts/fetch-releases.ts"
   },
   "dependencies": {
     "react": "latest",
@@ -19,4 +20,4 @@
     "@types/react": "latest",
     "typescript": "latest"
   }
-}
+}