fix: correct all broken URLs in README

- /category/* → /best/* (matching actual site routes)
- /deployments/* → /deploy/* (matching actual docs routes)
- Removed non-existent /guides/* URLs
- Fixed data source references (data/baas → data/tools.json)
- Fixed Garage GitHub link to deuxfleurs-org/garage
- Updated docs tip link

README.md

@@ -48,7 +48,7 @@ services:
       - ./pb_data:/pb_data
     restart: unless-stopped
 ```
-👉 [Open in Self-Hosted Configurator](https://thealtstack.com/self-hosted/pocketbase) • [Deployment Guide](https://docs.thealtstack.com/deployments/pocketbase)
+👉 [Open in Self-Hosted Configurator](https://thealtstack.com/self-hosted/pocketbase) • [Deployment Guide](https://docs.thealtstack.com/deploy/pocketbase)
 
 ### 📊 Plausible Analytics (Privacy-First)
 Lightweight, open-source analytics.
@@ -62,16 +62,16 @@ services:
     env_file: .env
 ...
 ```
-👉 [Open in Self-Hosted Configurator](https://thealtstack.com/self-hosted/plausible) • [Full Self-Hosting Guide](https://docs.thealtstack.com/deployments/plausible)
+👉 [Open in Self-Hosted Configurator](https://thealtstack.com/self-hosted/plausible) • [Full Self-Hosting Guide](https://docs.thealtstack.com/deploy/plausible)
 
 ---
 
 ## 🛠️ Browse by Category
 
-- [🏗️ Backend as a Service](#-backend-as-a-service-baas) → [Compare all on thealtstack.com](https://thealtstack.com/category/backend-as-a-service)
-- [💬 Communication](#-communication--collaboration) → [Compare all on thealtstack.com](https://thealtstack.com/category/communication)
-- [📊 Analytics & BI](#-analytics--bi) → [Compare all on thealtstack.com](https://thealtstack.com/category/analytics)
-- [📁 Project Management](#-project-management) → [Compare all on thealtstack.com](https://thealtstack.com/category/project-management)
+- [🏗️ Backend as a Service](#-backend-as-a-service-baas) → [Compare all on thealtstack.com](https://thealtstack.com/best/backend-as-a-service)
+- [💬 Communication](#-communication--collaboration) → [Compare all on thealtstack.com](https://thealtstack.com/best/communication)
+- [📊 Analytics & BI](#-analytics--bi) → [Compare all on thealtstack.com](https://thealtstack.com/best/analytics)
+- [📁 Project Management](#-project-management) → [Compare all on thealtstack.com](https://thealtstack.com/best/project-management)
 
 ---
 
@@ -82,14 +82,14 @@ services:
 - **[Supabase](https://github.com/supabase/supabase)** - The open source Firebase alternative with a dedicated Postgres database.
 - **[Appwrite](https://github.com/appwrite/appwrite)** - A complete backend for Flutter, Web, and Mobile developers.
 - **[PocketBase](https://github.com/pocketbase/pocketbase)** - Open source realtime backend in 1 file (Go & SQLite).
-- [🔗 **Compare BaaS Alternatives on AltStack**](https://thealtstack.com/category/backend-as-a-service)
+- [🔗 **Compare BaaS Alternatives on AltStack**](https://thealtstack.com/best/backend-as-a-service)
 
 ### 💬 Communication & Collaboration
 *Alternatives to **Slack**, **Zoom**, and **Microsoft Teams***
 - **[Mattermost](https://github.com/mattermost/mattermost)** - Open source platform for secure collaboration across the SDLC.
 - **[Rocket.Chat](https://github.com/RocketChat/Rocket.Chat)** - The Secure CommsOS™ for mission-critical operations.
 - **[Jitsi Meet](https://github.com/jitsi/jitsi-meet)** - Fully encrypted, 100% open source video conferencing.
-- [🔗 **Explore Communication Stacks on AltStack**](https://thealtstack.com/category/communication)
+- [🔗 **Explore Communication Stacks on AltStack**](https://thealtstack.com/best/communication)
 
 ### 📊 Analytics & BI
 *Alternatives to **Google Analytics**, **Mixpanel**, and **Tableau***
@@ -98,28 +98,28 @@ services:
 - **[Matomo](https://github.com/matomo-org/matomo)** - The leading open source Google Analytics alternative.
 - **[Metabase](https://github.com/metabase/metabase)** - The simplest way to get business intelligence throughout your company.
 - **[Apache Superset](https://github.com/apache/superset)** - Modern data exploration and visualization platform.
-- [🔗 **Check Analytics Guides on AltStack**](https://thealtstack.com/category/analytics)
+- [🔗 **Check Analytics on AltStack**](https://thealtstack.com/best/analytics)
 
-### <EFBFBD> Project Management
+### 📁 Project Management
 *Alternatives to **Jira**, **Asana**, and **Monday.com***
 - **[Plane](https://github.com/makeplane/plane)** - Beautiful open-source Jira/Linear alternative.
 - **[Taiga](https://github.com/taigaio/taiga-back)** - Agile project management for multi-functional teams.
 - **[OpenProject](https://github.com/opf/openproject)** - Powerful classic project management and collaboration.
-- [🔗 **Self-host Project Management on AltStack**](https://thealtstack.com/category/project-management)
+- [🔗 **Self-host Project Management on AltStack**](https://thealtstack.com/best/project-management)
 
 ### 🎨 Design & Creative
 *Alternatives to **Photoshop**, **Figma**, and **Illustrator***
 - **[Penpot](https://github.com/penpot/penpot)** - The open-source design tool for design and code collaboration (Figma alternative).
 - **[GIMP](https://github.com/GNOME/gimp)** - Professional-grade photo editing tools (Photoshop alternative).
 - **[Krita](https://github.com/KDE/krita)** - Open source digital painting (Illustrator/Corel alternative).
-- [🔗 **Design Stacks on AltStack**](https://thealtstack.com/category/design)
+- [🔗 **Design Tools on AltStack**](https://thealtstack.com/best/design)
 
-### <EFBFBD> Productivity & Knowledge
+### 📝 Productivity & Knowledge
 *Alternatives to **Notion**, **Microsoft 365**, and **Google Workspace***
 - **[AppFlowy](https://github.com/AppFlowy-IO/AppFlowy)** - Privacy-focused Notion alternative built in Rust.
 - **[AFFiNE](https://github.com/toeverything/AFFiNE)** - Next-gen knowledge base that brings planning and creation together.
 - **[ONLYOFFICE](https://github.com/ONLYOFFICE/DocumentServer)** - Highly compatible MS Office online editors.
-- [🔗 **Productivity Alternatives on AltStack**](https://thealtstack.com/category/productivity)
+- [🔗 **Productivity Alternatives on AltStack**](https://thealtstack.com/best/productivity)
 
 ### 🔐 Security & IAM
 *Alternatives to **1Password**, **Auth0**, and **Okta***
@@ -127,21 +127,21 @@ services:
 - **[KeePassXC](https://github.com/keepassxreboot/keepassxc)** - Fully offline, AES-256 password manager.
 - **[Keycloak](https://github.com/keycloak/keycloak)** - Open source identity and access management.
 - **[Authentik](https://github.com/goauthentik/authentik)** - The overall-best open-source identity provider.
-- [🔗 **Security Stacks on AltStack**](https://thealtstack.com/category/security)
+- [🔗 **Security Tools on AltStack**](https://thealtstack.com/best/security)
 
 ### 🛠️ DevOps & Automation
 *Alternatives to **Heroku**, **Zapier**, and **Vercel***
 - **[Coolify](https://github.com/coollabsio/coolify)** - Self-hostable PaaS alternative to Heroku & Netlify.
 - **[n8n](https://github.com/n8n-io/n8n)** - Workflow automation tool with 400+ integrations.
 - **[Activepieces](https://github.com/activepieces/activepieces)** - Open source Zapier alternative.
-- [🔗 **DevOps Guides on AltStack**](https://thealtstack.com/category/devops)
+- [🔗 **DevOps Tools on AltStack**](https://thealtstack.com/best/devops)
 
-### <EFBFBD> Storage & Infrastructure
+### 💾 Storage & Infrastructure
 *Alternatives to **AWS S3**, **Dropbox**, and **Salesforce***
-- **[Garage](https://github.com/deuxfleurs/garage)** - An open-source distributed object storage service tailored for self-hosting.
+- **[Garage](https://github.com/deuxfleurs-org/garage)** - An open-source distributed object storage service tailored for self-hosting.
 - **[Odoo](https://github.com/odoo/odoo)** - All-in-one ERP suite (Salesforce alternative).
 - **[Nextcloud](https://github.com/nextcloud/server)** - Content collaboration platform (Dropbox/Google Drive alternative).
-- [🔗 **Infrastructure Stacks on AltStack**](https://thealtstack.com/category/infrastructure)
+- [🔗 **Infrastructure on AltStack**](https://thealtstack.com/best/cloud-infrastructure)
 
 ---
 
@@ -154,7 +154,7 @@ Most tools in this list can be deployed in minutes using Docker. Here is how to
 3. **Go Sovereign**: Visit [docs.thealtstack.com](https://docs.thealtstack.com) for production-hardened guides (SSL, backups, and reverse proxies).
 
 > [!TIP]
-> This repository contains basic community configs. For commercial-grade Sovereign Infrastructure setup, always refer to our [Official Documentation](https://thealtstack.com/docs).
+> This repository contains basic community configs. For commercial-grade Sovereign Infrastructure setup, always refer to our [Official Documentation](https://docs.thealtstack.com).
 
 ```bash
 cd deployments/plausible
@@ -163,17 +163,17 @@ docker-compose up -d
 
 ---
 
-## <EFBFBD>️ Directory Mapping (The AltStack Bridge)
+## 🗺️ Directory Mapping (The AltStack Bridge)
 
 We use the data in this repository to power our [Main Website](https://thealtstack.com). Here is how the categories map:
 
 | UI Directory | Data Source (this repo) | Self-Hosted Guide |
 | :--- | :--- | :--- |
-| [Backend](https://thealtstack.com/category/backend-as-a-service) | `data/baas` | [BaaS Guides](https://docs.thealtstack.com/guides/backend) |
-| [Analytics](https://thealtstack.com/category/analytics) | `data/analytics` | [Analytics Guides](https://docs.thealtstack.com/guides/analytics) |
-| [Project Management](https://thealtstack.com/category/project-management) | `data/pm` | [PM Guides](https://docs.thealtstack.com/guides/pm) |
-| [Communication](https://thealtstack.com/category/communication) | `data/comms` | [Comms Guides](https://docs.thealtstack.com/guides/comms) |
-| [Productivity](https://thealtstack.com/category/productivity) | `data/productivity` | [Prod Guides](https://docs.thealtstack.com/guides/productivity) |
+| [Backend](https://thealtstack.com/best/backend-as-a-service) | `data/tools.json` | [Deploy Guides](https://docs.thealtstack.com/deploy/supabase) |
+| [Analytics](https://thealtstack.com/best/analytics) | `data/tools.json` | [Deploy Guides](https://docs.thealtstack.com/deploy/plausible) |
+| [Project Management](https://thealtstack.com/best/project-management) | `data/tools.json` | [Deploy Guides](https://docs.thealtstack.com/deploy/plane) |
+| [Communication](https://thealtstack.com/best/communication) | `data/tools.json` | [Deploy Guides](https://docs.thealtstack.com/deploy/mattermost) |
+| [Productivity](https://thealtstack.com/best/productivity) | `data/tools.json` | [Deploy Guides](https://docs.thealtstack.com/deploy/appflowy) |
 
 ---