⚙️ Application Configuration

Use the interactive settings panel below to configure your website URL, trainee credentials, Cloudflare deployment variables, and external APIs.

Your settings are saved directly in your browser's local storage and dynamically generate ready-to-use configuration files (.env, wrangler.toml, .vitepress/config.mts).

---

---

🛠️ Configuration Architecture Explained

Your IRS Knowledge Base uses a lightweight configuration stack designed for zero-maintenance:

1. VitePress Core (.vitepress/config.mts)

The main website configuration file controls site title, navigation links, and built-in search:

• title: The website title shown in the browser tab and navbar.
• cleanUrls: true: Removes .html extensions from URLs (e.g., /procedures/module-story-method instead of /procedures/module-story-method.html).
• search: { provider: 'local' }: Enables instant offline fuzzy keyword search across all pages.
• nav & sidebar: Controls the top header links and the collapsible left-hand menu.

---

2. Cloudflare Pages (wrangler.toml)

Cloudflare reads wrangler.toml during build and deployment:

name = "irs-knowledge-base"
pages_build_output_dir = "docs/.vitepress/dist"
compatibility_date = "2024-09-01"

To configure custom environment variables in Cloudflare Pages:

1. Go to Cloudflare Dashboard > Workers & Pages > Select your project.
2. Click Settings > Environment variables.
3. Add variables like SITE_URL or API_ENDPOINT for Production and Preview branches.

---

3. Setting Up a Custom Domain on Cloudflare

Cloudflare Pages provides a free *.pages.dev subdomain by default (e.g., https://irs-knowledge-base.pages.dev).

To add your own custom domain (e.g. kb.yourname.com):

1. In Cloudflare Dashboard, go to your Pages project > Custom domains.
2. Click Set up a custom domain.
3. Enter your domain name and click Continue.
4. Cloudflare automatically issues and manages free SSL certificates with instant HTTP-to-HTTPS redirect.

---

4. Adding External APIs & Webhooks

If you wish to connect your knowledge base to external services (such as automated note backups, Slack/Discord study alerts, or a personal database):

• Add your webhook or API URL in the Cloudflare & Integrations card above.
• The interactive tool will format the corresponding environment keys in .env for safe usage.