Merge pull request #20 from MMRLApp/copilot/optimize-google-indexing

Implement comprehensive SEO optimization for Google indexing

Author: DerGoogler

.github/workflows/deploy-website.yml

@@ -4,9 +4,6 @@ on:
   schedule:
     - cron: '0 */6 * * *'
   push:
-    branches:
-      - master
-      - website
     paths:
       - '.github/workflows/deploy-website.yml'
       - '**'
@@ -48,6 +45,7 @@ jobs:
           path: docs/.vitepress/dist
 
   deploy:
+    if: ${{ github.ref == 'refs/heads/master' }}
     environment:
       name: github-pages
       url: ${{ steps.deployment.outputs.page_url }}
@@ -57,4 +55,4 @@ jobs:
     steps:
       - name: Deploy to GitHub Pages
         id: deployment
-        uses: actions/deploy-pages@v4
+        uses: actions/deploy-pages@v4

README.md

@@ -1,2 +1,71 @@
 # MMRLApp.github.io
-Website 🤓
+
+Official website for MMRL (Magisk Module Repo Loader) 🤓
+
+## About
+
+This repository contains the source code for [mmrl.dev](https://mmrl.dev), the official website and documentation for MMRL - an advanced Android application for managing Magisk, KernelSU, and APatch modules.
+
+## Development
+
+```bash
+# Install dependencies
+npm install
+
+# Run development server
+npm run docs:dev
+
+# Build for production
+npm run docs:build
+
+# Preview production build
+npm run docs:preview
+```
+
+## SEO Optimizations
+
+This website has been optimized for search engine visibility and performance:
+
+### Technical SEO
+- **robots.txt**: Configured to allow search engine crawlers while protecting API endpoints
+- **Meta tags**: Comprehensive meta descriptions, Open Graph, and Twitter Card tags
+- **Structured Data**: JSON-LD schema for better search engine understanding
+- **Canonical URLs**: Automatic canonical URL generation for all pages
+- **Sitemap**: Automatically generated sitemap at `/sitemap.xml`
+- **Mobile-friendly**: Responsive design with proper viewport configuration
+- **Performance**: Asset minification and optimized chunk splitting
+
+### Content SEO
+- **Internal Linking**: Strategic internal links with descriptive anchor text
+- **Meta Descriptions**: Unique, descriptive meta descriptions for all major pages
+- **Semantic HTML**: Proper heading hierarchy and semantic markup
+- **Alt Text**: Descriptive alt text for all images
+
+### Off-site SEO
+See [SEO-ACTIONS.md](./SEO-ACTIONS.md) for a comprehensive guide on:
+- Building high-quality backlinks
+- Content promotion strategies
+- Community engagement tactics
+- Long-term SEO planning
+
+## Technology Stack
+
+- **Framework**: [VitePress](https://vitepress.dev/) - Fast static site generator
+- **UI**: Vue 3 components with custom styling
+- **Search**: Pagefind for local search functionality
+- **Deployment**: GitHub Pages with automatic updates every 6 hours
+
+## Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.
+
+## License
+
+MIT License - see repository for details
+
+---
+
+**Maintained by**: Der_Googler and MMRL Contributors  
+**Website**: [mmrl.dev](https://mmrl.dev)  
+**GitHub**: [MMRLApp/MMRL](https://github.com/MMRLApp/MMRL)
+

docs/.vitepress/config/shared.ts

@@ -14,6 +14,13 @@ import { getAllContributorsRecursive } from "../../data/contributors.data";
 export const shared = defineConfig({
   vite: {
     plugins: [ViteYaml(), pagefindPlugin()],
+    build: {
+      // Optimize assets for better performance
+      minify: "terser",
+      cssMinify: true,
+      // Optimize chunk size for better loading
+      chunkSizeWarningLimit: 1000,
+    },
   },
   markdown: {
     lineNumbers: true,
@@ -23,10 +30,94 @@ export const shared = defineConfig({
   },
   cleanUrls: true,
   title: "MMRL",
+  description:
+    "MMRL - A decentralized ecosystem for sharing, distributing, and discovering Magisk modules. Comprehensive root manager support for Magisk, KernelSU, and APatch.",
   sitemap: {
     hostname: "https://mmrl.dev",
   },
   head: [
+    // Favicon and App Icons
+    ["link", { rel: "icon", href: "/favicon.ico" }],
+    ["link", { rel: "apple-touch-icon", href: "/VitePressLogo-512px.webp" }],
+
+    // SEO Meta Tags
+    [
+      "meta",
+      {
+        name: "keywords",
+        content: "MMRL, Magisk modules, KernelSU, APatch, Android root, module repository, Magisk Module Repo Loader, module management",
+      },
+    ],
+    ["meta", { name: "author", content: "Der_Googler and MMRL Contributors" }],
+    ["meta", { name: "robots", content: "index, follow" }],
+    ["meta", { name: "googlebot", content: "index, follow" }],
+
+    // Open Graph / Facebook
+    ["meta", { property: "og:type", content: "website" }],
+    ["meta", { property: "og:url", content: "https://mmrl.dev" }],
+    ["meta", { property: "og:title", content: "MMRL - Magisk Module Repo Loader" }],
+    [
+      "meta",
+      {
+        property: "og:description",
+        content:
+          "A decentralized ecosystem for sharing, distributing, and discovering Magisk modules with comprehensive root manager support.",
+      },
+    ],
+    ["meta", { property: "og:image", content: "https://mmrl.dev/VitePressLogo-512px.webp" }],
+    ["meta", { property: "og:site_name", content: "MMRL" }],
+
+    // Twitter Card
+    ["meta", { name: "twitter:card", content: "summary_large_image" }],
+    ["meta", { name: "twitter:url", content: "https://mmrl.dev" }],
+    ["meta", { name: "twitter:title", content: "MMRL - Magisk Module Repo Loader" }],
+    [
+      "meta",
+      {
+        name: "twitter:description",
+        content:
+          "A decentralized ecosystem for sharing, distributing, and discovering Magisk modules with comprehensive root manager support.",
+      },
+    ],
+    ["meta", { name: "twitter:image", content: "https://mmrl.dev/VitePressLogo-512px.webp" }],
+
+    // Mobile Optimization
+    ["meta", { name: "viewport", content: "width=device-width, initial-scale=1.0, viewport-fit=cover" }],
+    ["meta", { name: "mobile-web-app-capable", content: "yes" }],
+    ["meta", { name: "apple-mobile-web-app-capable", content: "yes" }],
+    ["meta", { name: "apple-mobile-web-app-status-bar-style", content: "black-translucent" }],
+
+    // Theme Color
+    ["meta", { name: "theme-color", content: "#3eaf7c" }],
+
+    // Canonical URL (will be set per page by VitePress)
+    ["link", { rel: "canonical", href: "https://mmrl.dev" }],
+
+    // Structured Data - Organization
+    [
+      "script",
+      { type: "application/ld+json" },
+      JSON.stringify({
+        "@context": "https://schema.org",
+        "@type": "SoftwareApplication",
+        name: "MMRL",
+        applicationCategory: "UtilitiesApplication",
+        operatingSystem: "Android",
+        description: "Magisk Module Repo Loader - A decentralized ecosystem for sharing, distributing, and discovering Magisk modules",
+        url: "https://mmrl.dev",
+        author: {
+          "@type": "Person",
+          name: "Der_Googler",
+        },
+        license: "GLPv3",
+        softwareHelp: {
+          "@type": "WebSite",
+          url: "https://github.com/MMRLApp/MMRL/issues",
+        },
+      }),
+    ],
+
+    // Google Ads
     [
       "script",
       {
@@ -50,6 +141,24 @@ export const shared = defineConfig({
       pageData.description = pageData.params.description;
     }
   },
+  transformHead({ pageData }) {
+    // Add canonical URL for each page
+    const canonicalUrl = `https://mmrl.dev/${pageData.relativePath.replace(/\.md$/, "")}`;
+
+    return [
+      ["link", { rel: "canonical", href: canonicalUrl }],
+      // Add page-specific Open Graph tags
+      ["meta", { property: "og:url", content: canonicalUrl }],
+      ["meta", { property: "og:title", content: pageData.title }],
+      [
+        "meta",
+        {
+          property: "og:description",
+          content: pageData.description || pageData.frontmatter?.description || "MMRL - Magisk Module Repo Loader",
+        },
+      ],
+    ];
+  },
   buildEnd: async (config: SiteConfig) => {
     const publicApi = resolve(config.outDir, "api");
     const placeholder = resolve(publicApi, "placeholder");

docs/en/blacklist/index.md

@@ -1,6 +1,6 @@
 ---
-title: Blacklist
-descriptions: A list of blacklisted modules in MMRL
+title: MMRL Blacklist - Restricted Modules
+description: View the complete list of blacklisted Magisk modules in MMRL. Transparency about which modules are restricted and why, ensuring user safety and informed decisions.
 editLink: false
 prev: false
 next: false

docs/en/downloads.md

@@ -2,6 +2,8 @@
 editLink: false
 prev: false
 next: false
+title: Download MMRL - Magisk Module Repo Loader
+description: Download the latest version of MMRL (Magisk Module Repo Loader) for Android. Get APK files from GitHub releases and Google Play Store for managing your Magisk modules.
 ---
 
 # MMRL Downloads

docs/en/guide/faq.md

@@ -1,3 +1,8 @@
+---
+title: MMRL FAQ - Frequently Asked Questions
+description: Common questions about MMRL - Magisk Module Repo Loader. Learn about JavaScript APIs, WebUI shortcuts, APK variants, and module management features.
+---
+
 # FAQ
 
 ## How to enable JavaScript APIs in MMRL?

docs/en/guide/index.md

@@ -1,44 +1,48 @@
-# What is MMRL
+# What is MMRL?
 
-Magisk Module Repo Loader (MMRL) is an advanced, open-source Android application developed by Der_Googler, designed to streamline the management of modules for Magisk, KernelSU, and APatch. This highly configurable tool empowers users to efficiently handle their own module repositories, all within an ad-free environment.
+Magisk Module Repo Loader (MMRL) is an advanced, open-source Android application developed by Der_Googler, designed to streamline the management of modules for [Magisk](https://github.com/topjohnwu/Magisk), [KernelSU](https://kernelsu.org/), and [APatch](https://apatch.dev/). This highly configurable tool empowers users to efficiently handle their own module repositories, all within an ad-free environment.
 
-## Features
+## Key Features
 
-- **Comprehensive Root Manager Support**: MMRL offers full compatibility with Magisk, KernelSU, and APatch, providing users with a versatile platform for root management.
+- **Comprehensive Root Manager Support**: MMRL offers full compatibility with Magisk, KernelSU, and APatch, providing users with a versatile platform for root management. Learn more about [how module cards work](how-a-module-card-works).
 
 - **User-Friendly Interface**: The application boasts a user-centric design, featuring edge-to-edge support and dynamic app themes, ensuring a seamless and intuitive user experience.
 
-- **Bulk Module Installation**: Users can install multiple modules simultaneously, whether sourced online or from local storage, enhancing efficiency in module management.
+- **Bulk Module Installation**: Users can install multiple modules simultaneously, whether sourced from [online repositories](../repository/) or from local storage, enhancing efficiency in module management.
 
 - **Module Dependency Management**: MMRL simplifies the installation process by automatically handling module dependencies, ensuring that all necessary components are in place for optimal functionality.
 
-- **Customizable Module Pages**: The application allows for personalized module pages, enabling the addition of categories, screenshots, icons, covers, and other content to tailor the presentation to user preferences.
+- **Customizable Module Pages**: The application allows for personalized module pages, enabling the addition of categories, screenshots, icons, covers, and other content to tailor the presentation to user preferences. Check out our [text formatting guide](text-formatting).
 
-- **Transparency of Included Files**: MMRL provides a detailed breakdown of all files within modules, including APKs and service files, ensuring users have full visibility into the components of each module.
+- **Transparency of Included Files**: MMRL provides a detailed breakdown of all files within modules, including APKs and service files, ensuring users have full visibility into the components of each module. Read about [anti-features](antifeatures) for security considerations.
 
 - **Analytics Dashboard**: An integrated analytics dashboard displays module-related insights on the homepage, offering valuable information on module usage and trends.
 
 - **Command-Line Interface (MMRL-CLI)**: For users who prefer terminal-based interactions, MMRL offers a Command-Line Interface, MMRL-CLI, which facilitates seamless module installation and management directly from the terminal.
 
-## How to Use
+- **Powerful WebUI X**: MMRL features [WebUI X](webuix/), one of the most advanced module configuration interfaces, providing developers with powerful tools to create native-feeling experiences.
+
+## How to Use MMRL
 
 To get started with MMRL, follow these steps:
 
 1. **Installation**:
-   - Download the latest version of MMRL from the official website or a trusted repository.
-   - Install the application on your Android device.
+   - Download the latest version of MMRL from the [downloads page](../downloads) or [Google Play Store](https://play.google.com/store/apps/details?id=com.dergoogler.mmrl).
+   - Install the application on your rooted Android device.
 
 2. **Adding Repositories**:
    - Open MMRL and navigate to the repository management section.
    - Add your desired module repositories by entering their URLs.
+   - Browse our [curated repositories](../repository/) to discover popular modules.
 
 3. **Managing Modules**:
    - Browse through the available modules in your added repositories.
    - Select modules to install, update, enable, disable, or remove as needed.
+   - Review module details and check for [anti-features](antifeatures) before installation.
 
-For a comprehensive guide on installation and usage, please refer to the [MMRL GitHub Repository](https://github.com/MMRLApp/MMRL).
+For a comprehensive guide on installation and usage, please refer to the [MMRL GitHub Repository](https://github.com/MMRLApp/MMRL) and our [FAQ page](faq).
 
-## How to Build
+## How to Build MMRL
 
 If you're interested in building MMRL from source, follow these steps:
 
@@ -56,10 +60,19 @@ If you're interested in building MMRL from source, follow these steps:
 
 For detailed instructions and troubleshooting, please refer to the [MMRL GitHub Repository](https://github.com/MMRLApp/MMRL).
 
-## Discussion
+## Developer Resources
+
+If you're a module developer, check out these resources:
+
+- [MMRL-Util Guide](mmrl-util/) - Tools for creating and managing module repositories
+- [WebUI X Documentation](webuix/) - Build advanced module configuration interfaces
+- [Legacy Installer API](installer) - Traditional module installation methods
+
+## Discussion & Community
 
 Join the community discussion to share experiences, seek assistance, and stay updated with the latest developments:
 
 - **Telegram**: [@MMRLApp](https://t.me/MMRLApp)
+- **GitHub**: [MMRL Repository](https://github.com/MMRLApp/MMRL)
 
 Engaging with the community can provide valuable insights and support as you navigate the features and functionalities of MMRL. 

docs/en/guide/mmrl-util/index.md

@@ -1,3 +1,8 @@
+---
+title: MMRL-Util - Build Your Own Module Repository
+description: Complete guide to MMRL-Util for creating custom Magisk module repositories. Learn installation, configuration, and management of your own module repository.
+---
+
 # Magisk Modules Repo Util
 
 This util is to build module repository for [MMRL](https://github.com/DerGoogler/MMRL)

docs/en/guide/webuix/index.md

@@ -1,3 +1,8 @@
+---
+title: WebUI X - Next-Generation Module Interface Framework
+description: Learn about WebUI X, MMRL's powerful framework for building secure, high-performance module configuration interfaces. Enhanced security, debugging tools, and modern UX features.
+---
+
 # Why WebUI X?
 
 WebUI X is the next-generation framework for building modular, secure, and high-performance WebUI applications. It offers significant improvements over Legacy KernelSU WebUI, making it the ideal choice for developers. Below are the key reasons to switch: