Fast bridge doc

[Sipher]

Summary by CodeRabbit

Release Notes

• New Features

  • Added custom 404 error page with navigation links and feedback channels
  • Introduced Fast Bridge documentation for streamlined token bridging

• Documentation

  • Added Standard Bridge guide with comprehensive multi-step instructions
  • Updated navigation menu with bridge routing options

• Chores

  • Enhanced server performance with gzip compression and long-term asset caching
  • Implemented security headers for improved protection

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Preview	Comments	Updated (UTC)
torus-docs	Ready	Preview	Comment	Nov 1, 2025 3:00pm

[coderabbitai]

Caution

Review failed

The pull request is closed.

Walkthrough

This PR adds comprehensive bridge documentation with two alternative flows (Fast Bridge and Standard Bridge), updates the site navigation to reflect these options, configures a custom nginx setup for the production build with gzip compression and security headers, and introduces a custom 404 error page with user guidance and contact options.

Changes

Cohort / File(s)	Summary
Docker & Web Server Configuration Dockerfile, nginx.conf	Adds custom nginx configuration file with gzip compression, security headers (X-Frame-Options, X-Content-Type-Options, X-XSS-Protection), static asset caching (1 year expiry), and custom 404 page routing. Updates Dockerfile to copy the configuration into the image build.
Navigation & Site Structure astro.config.mjs, src/content/docs/how-to-guides/table-of-contents.mdx	Replaces "Bridge from Base" navigation entry with "Fast Bridge" and adds new "Standard Bridge" entry in sidebar and table of contents.
Bridge Documentation src/content/docs/how-to-guides/holders/fast-bridge.mdx, src/content/docs/how-to-guides/holders/standard-bridge.mdx	Introduces two new bridge guides: Fast Bridge for bidirectional TORUS bridging between Base and Native networks, and Standard Bridge providing a multi-phase workflow across Base → Torus EVM → Torus with detailed step-by-step instructions and visual aids.
Error Handling src/content/docs/404.mdx	Adds custom 404 error page with animated asset, navigation links to core sections, and contact options (Discord, Telegram) for user feedback.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~12 minutes

• nginx.conf: Validate standard nginx security practices and caching directives (no application logic, standard configuration patterns)
• Bridge documentation files: Verify consistent formatting, image references, component usage, and instructional clarity across two similar guides
• Navigation updates: Cross-check consistency between astro.config.mjs and table-of-contents.mdx file paths and ordering

Possibly related PRs

• Add better error 404 handling to the docs #41: Directly overlaps on code-level changes—adds the same nginx.conf file, Dockerfile modification, and 404.mdx custom error page.
• New hover functionality #27: Modifies the same astro.config.mjs sidebar navigation structure, updating "For Holders" bridge-related entries.
• Add more how-to guides to prepare for next release cycle #14: Updates astro.config.mjs sidebar configuration to add how-to guide documentation entries alongside the bridge documentation.

Poem

🐰 Bridges built in documentation bright,
Fast and standard paths take flight,
Nginx guards with cache and care,
When lost, our 404 leads you there!
Two routes to cross, one error page—
A rabbit's gift on every stage. 🌉

✨ Finishing touches

• 📝 Generate docstrings

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Post copyable unit tests in a comment
• Commit unit tests in branch dev

---

📜 Recent review details

Configuration used: CodeRabbit UI

Review profile: CHILL

Plan: Pro

Disabled knowledge base sources:

• Linear integration is disabled by default for public repositories

You can enable these sources in your CodeRabbit configuration.

📥 Commits

Reviewing files that changed from the base of the PR and between 4bd4e41 and 10b7797.

⛔ Files ignored due to path filters (3)

• public/images/how-to-guide/simple-bridge/bridge-mecannisms.png is excluded by !**/*.png
• public/images/how-to-guide/simple-bridge/connect-both-wallets.png is excluded by !**/*.png
• src/assets/travolta-lost.gif is excluded by !**/*.gif

📒 Files selected for processing (7)

• Dockerfile (1 hunks)
• astro.config.mjs (1 hunks)
• nginx.conf (1 hunks)
• src/content/docs/404.mdx (1 hunks)
• src/content/docs/how-to-guides/holders/fast-bridge.mdx (1 hunks)
• src/content/docs/how-to-guides/holders/standard-bridge.mdx (1 hunks)
• src/content/docs/how-to-guides/table-of-contents.mdx (1 hunks)

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}