@mgks/docmd 0.2.6 → 0.2.8

package/.github/CODE_OF_CONDUCT.md

@@ -0,0 +1,48 @@
+# Contributor Covenant Code of Conduct
+
+## Our Pledge
+
+We as members, contributors, and leaders pledge to make participation in our
+community a harassment-free experience for everyone, regardless of age, body
+size, visible or invisible disability, ethnicity, sex characteristics, gender
+identity and expression, level of experience, education, socio-economic status,
+nationality, personal appearance, race, religion, or sexual identity
+and orientation.
+
+We pledge to act and interact in ways that contribute to an open, welcoming,
+diverse, inclusive, and healthy community.
+
+## Our Standards
+
+Examples of behavior that contributes to a positive environment for our
+community include:
+
+* Demonstrating empathy and kindness toward other people
+* Being respectful of differing opinions, viewpoints, and experiences
+* Giving and gracefully accepting constructive feedback
+* Accepting responsibility and apologizing to those affected by our mistakes,
+  and learning from the experience
+* Focusing on what is best not just for us as individuals, but for the
+  overall community
+
+## Enforcement Responsibilities
+
+Community leaders are responsible for clarifying and enforcing our standards of
+acceptable behavior and will take appropriate and fair corrective action in
+response to any behavior that they deem inappropriate, threatening, offensive,
+or harmful.
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be
+reported to the community leaders responsible for enforcement at hello@mgks.dev.
+All complaints will be reviewed and investigated promptly and fairly.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant][homepage],
+version 2.1, available at
+[https://www.contributor-covenant.org/version/2/1/code_of_conduct.html][v2.1].
+
+[homepage]: https://www.contributor-covenant.org
+[v2.1]: https://www.contributor-covenant.org/version/2/1/code_of_conduct.html

package/.github/CONTRIBUTING.md

@@ -0,0 +1,129 @@
+# Contributing to docmd
+
+First off, thank you for considering contributing to `docmd`! It's people like you that make the open-source community such an amazing place to learn, inspire, and create.
+
+We welcome contributions of all kinds: bug fixes, new features, documentation improvements, or even just typo fixes.
+
+## ⚡ Quick Links
+
+*   [**Documentation**](https://docmd.mgks.dev) - Read the docs to understand how the tool works.
+*   [**GitHub Issues**](https://github.com/mgks/docmd/issues) - Browse existing bugs or feature requests.
+*   [**Discussions**](https://github.com/mgks/docmd/discussions) - Ask questions or share ideas.
+
+---
+
+## 🛠️ Development Setup
+
+`docmd` is a Node.js CLI tool. Developing it locally requires a slightly different setup than a standard web app.
+
+### Prerequisites
+*   **Node.js**: Version 22.x or higher.
+*   **npm**: Version 10.x or higher.
+
+### 1. Fork and Clone
+1.  Fork the repository to your GitHub account.
+2.  Clone your fork locally:
+    ```bash
+    git clone https://github.com/YOUR_USERNAME/docmd.git
+    cd docmd
+    ```
+
+### 2. Install Dependencies
+```bash
+npm install
+```
+
+### 3. Link for Local Development
+To test the CLI command (`docmd`) globally on your machine while modifying the source code, use `npm link`.
+
+```bash
+# inside the project root
+npm link
+```
+
+Now, when you run `docmd` in *any* terminal window, it will use the code from your local folder.
+
+### 4. Running the Dev Server
+We have a built-in test site located in the `docs/` folder (this is the documentation for docmd itself).
+
+To start the dev server and watch for changes:
+
+```bash
+# Method 1: Using the npm script (Recommended)
+npm start
+
+# Method 2: If you have linked the package
+docmd dev
+```
+
+### 5. Developer Mode (Important)
+By default, `docmd` only watches the user's content files. To make `docmd` watch **its own internal source code** (templates, css, core logic) and trigger a rebuild when you edit them, set the environment variable:
+
+```bash
+# Mac/Linux
+export DOCMD_DEV=true
+npm start
+
+# Windows (PowerShell)
+$env:DOCMD_DEV="true"
+npm start
+```
+
+---
+
+## 📂 Project Structure
+
+Here is a map of the codebase to help you navigate:
+
+```text
+bin/
+  └── docmd.js          # The CLI entry point
+src/
+  ├── commands/         # Logic for 'init', 'build', 'dev'
+  ├── core/
+  │   ├── config-loader.js   # Loads docmd.config.js
+  │   ├── config-validator.js # Validates config structure
+  │   ├── file-processor.js  # Orchestrates file reading
+  │   ├── html-generator.js  # Injects content into EJS templates
+  │   └── markdown/          # The Core Parsing Engine
+  │       ├── containers.js  # Callout/Card definitions
+  │       ├── rules.js       # Complex logic (Tabs, Changelogs)
+  │       └── setup.js       # MarkdownIt configuration
+  ├── plugins/          # Built-in plugins (SEO, Sitemap)
+  ├── templates/        # EJS HTML templates
+  └── assets/           # Internal CSS and JS (Themes)
+docs/                   # The documentation site content
+site/                   # The generated output folder (gitignored)
+```
+
+---
+
+## 🚀 Submitting a Pull Request
+
+1.  **Create a Branch:** Always create a new branch for your changes.
+    *   `feat/my-new-feature`
+    *   `fix/bug-description`
+    *   `docs/update-readme`
+2.  **Make Changes:** Write clear, concise code.
+3.  **Test:**
+    *   Run `docmd build` to ensure the build process finishes without errors.
+    *   Verify your changes visually by running `docmd dev`.
+4.  **Commit:** We prefer [Conventional Commits](https://www.conventionalcommits.org/).
+    *   `feat: add search bar`
+    *   `fix: resolve css overflow in tables`
+    *   `docs: fix typo in readme`
+5.  **Push & Open PR:** Push your branch to your fork and open a Pull Request against the `main` branch of `mgks/docmd`.
+
+---
+
+## 🎨 Style Guidelines
+
+*   **Linting:** Please ensure your code follows the existing style. (We use standard ESLint/Prettier configurations).
+*   **No-Style:** If modifying `no-style` templates, ensure no external CSS is injected unless requested.
+*   **Compatibility:** `docmd` aims to be lightweight. Avoid adding heavy dependencies unless absolutely necessary.
+
+---
+
+## 🤝 Community
+
+Please note that this project is released with a [Contributor Code of Conduct](CODE_OF_CONDUCT.md). By participating in this project you agree to abide by its terms.

package/.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,58 @@
+name: 🐞 Bug Report
+description: Create a report to help us improve docmd
+title: "[Bug]: "
+labels: ["bug", "triage"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for taking the time to fill out this bug report!
+  - type: input
+    id: version
+    attributes:
+      label: docmd version
+      description: What version of docmd are you using? (e.g. 0.2.6)
+      placeholder: 0.2.6
+    validations:
+      required: true
+  - type: input
+    id: node-version
+    attributes:
+      label: Node.js version
+      placeholder: v20.x
+    validations:
+      required: true
+  - type: dropdown
+    id: os
+    attributes:
+      label: OS
+      options:
+        - macOS
+        - Windows
+        - Linux
+    validations:
+      required: true
+  - type: textarea
+    id: description
+    attributes:
+      label: Description
+      description: A clear and concise description of what the bug is.
+    validations:
+      required: true
+  - type: textarea
+    id: reproduction
+    attributes:
+      label: Steps to Reproduce
+      description: Please provide the steps to reproduce the behavior.
+      placeholder: |
+        1. Run 'docmd init'
+        2. Add configuration...
+        3. Run 'docmd build'
+        4. See error...
+    validations:
+      required: true
+  - type: textarea
+    id: expected
+    attributes:
+      label: Expected Behavior
+      description: A clear and concise description of what you expected to happen.

package/.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,27 @@
+name: 💡 Feature Request
+description: Suggest an idea for this project
+title: "[Feature]: "
+labels: ["enhancement"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for suggesting a new feature!
+  - type: textarea
+    id: problem
+    attributes:
+      label: Is your feature request related to a problem?
+      description: A clear and concise description of what the problem is.
+      placeholder: I'm always frustrated when...
+  - type: textarea
+    id: solution
+    attributes:
+      label: Describe the solution you'd like
+      description: A clear and concise description of what you want to happen.
+    validations:
+      required: true
+  - type: textarea
+    id: alternatives
+    attributes:
+      label: Describe alternatives you've considered
+      description: A clear and concise description of any alternative solutions or features you've considered.

package/.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,16 @@
+## Description
+<!-- Please include a summary of the change and which issue is fixed. -->
+
+Fixes # (issue)
+
+## Type of change
+- [ ] 🐛 Bug fix (non-breaking change which fixes an issue)
+- [ ] ✨ New feature (non-breaking change which adds functionality)
+- [ ] 💥 Breaking change (fix or feature that would cause existing functionality to not work as expected)
+- [ ] 📝 Documentation update
+
+## Checklist:
+- [ ] I have performed a self-review of my own code
+- [ ] I have commented my code, particularly in hard-to-understand areas
+- [ ] I have made corresponding changes to the documentation
+- [ ] My changes generate no new warnings

package/.github/SECURITY.md

@@ -0,0 +1,18 @@
+# Security Policy
+
+## Supported Versions
+
+| Version | Supported          |
+| ------- | ------------------ |
+| 0.2.x   | :white_check_mark: |
+| 0.1.x   | :x:                |
+
+## Reporting a Vulnerability
+
+Use this section to tell people how to report a vulnerability.
+
+Please do not report security vulnerabilities through public GitHub issues.
+
+If you have discovered a security vulnerability in `docmd`, please email hello@mgks.dev.
+
+We will do our best to respond within 48 hours.

package/.github/workflows/publish.yml

@@ -2,83 +2,48 @@ name: Publish Package to NPM and GitHub Packages
 
 on:
   release:
-    types: [created] # [created, published] Triggers when a new GitHub Release is created or published
-  workflow_dispatch: # Allows manual triggering for testing
+    types: [published]
+  workflow_dispatch:
 
 jobs:
   publish:
     runs-on: ubuntu-latest
     permissions:
       contents: read
-      packages: write # Required for GitHub Packages
+      packages: write
     steps:
       - name: Checkout repository
         uses: actions/checkout@v4
-        # Your package.json in the workspace should now have name: "@mgks/docmd"
 
-      - name: Set up Node.js (common for all steps)
+      - name: Set up Node.js v22
         uses: actions/setup-node@v4
         with:
           node-version: '22'
-          cache: 'npm' # Cache npm dependencies
+          cache: 'npm'
 
       - name: Install dependencies
         run: npm ci
 
-      # Optional: Run build script if you have one for the package itself
-      # - name: Build package
-      #   run: npm run build
-
-      # Optional: Run tests
-      # - name: Test package
-      #   run: npm test
-
+      # ------------------------------------------
       # --- Publish to NPM Registry (npmjs.com) ---
-      - name: Set up Node.js for npmjs.com
-        uses: actions/setup-node@v4
-        with:
-          node-version: '22' # Redundant if already set, but harmless
-          registry-url: 'https://registry.npmjs.org/'
-        env:
-          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }} # Configures .npmrc for npmjs.com
+      # ------------------------------------------
+      - name: Configure NPM for public registry
+        run: echo "//registry.npmjs.org/:_authToken=${{ secrets.NPM_TOKEN }}" > ~/.npmrc
 
-      # No need to change package.json name if it's already @mgks/docmd
-      # Just ensure no GPR-specific publishConfig is present
-      - name: Prepare package.json for npmjs.com
-        run: |
-          echo "package.json for npmjs.com publishing (should be @mgks/docmd):"
-          cat package.json
-          # Remove publishConfig if it exists, just in case
-          if jq -e '.publishConfig' package.json > /dev/null; then
-            echo "Removing publishConfig for npmjs.com publish"
-            jq 'del(.publishConfig)' package.json > package_temp.json && mv package_temp.json package.json
-          else
-            echo "No publishConfig found, package.json is ready for npmjs.com."
-          fi
-          cat package.json
-
-      - name: Publish to NPM Registry (npmjs.com)
-        # For scoped packages on npmjs.com, --access=public is needed for the first publish
-        # and if it's intended to be a public package.
+      - name: Publish to NPM Registry
         run: npm publish --access=public
-
-      # --- Publish to GitHub Packages ---
-      - name: Set up Node.js for GitHub Packages
-        uses: actions/setup-node@v4
-        with:
-          node-version: '22' # Redundant if already set, but harmless
-          registry-url: 'https://npm.pkg.github.com'
-          # scope: '@mgks' # Not strictly needed here if package.json name is already @mgks/docmd
-                           # but good for ensuring .npmrc is correctly configured for the @mgks scope.
         env:
-          NODE_AUTH_TOKEN: ${{ secrets.GITHUB_TOKEN }} # Configures .npmrc for GPR
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
 
-      # The package name is already @mgks/docmd from checkout (and npmjs.com step didn't change it).
-      # No jq transformation of the name is needed.
-      - name: Verify package.json for GitHub Packages
+      # ----------------------------------------
+      # --- Publish to GitHub Packages (GPR) ---
+      # ----------------------------------------
+      - name: Configure NPM for GitHub Packages registry
         run: |
-          echo "package.json for GPR publishing (should be @mgks/docmd):"
-          cat package.json
+          echo "@mgks:registry=https://npm.pkg.github.com" > ~/.npmrc
+          echo "//npm.pkg.github.com/:_authToken=${{ secrets.GITHUB_TOKEN }}" >> ~/.npmrc
 
       - name: Publish to GitHub Packages
-        run: npm publish
+        run: npm publish
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.GITHUB_TOKEN }}

package/README.md

@@ -1,108 +1,160 @@
 <p align="center">
-  <img src="https://github.com/mgks/docmd/blob/main/src/assets/images/docmd-logo.png" alt="docmd logo" width="70" />
-  <br />
-  <img src="https://github.com/mgks/docmd/blob/main/src/assets/images/docmd-logo-light.png" alt="docmd dark logo" width="180" />
+  <br>
+  <a href="https://docmd.mgks.dev">
+    <img src="https://github.com/mgks/docmd/blob/main/src/assets/images/docmd-logo-light.png?raw=true" alt="docmd logo" width="200" />
+  </a>
 </p>
 
 <p align="center">
-  <b>Generate beautiful, lightweight static documentation sites from Markdown files.</b>
-  <br>Zero clutter, just content.
+  <b>The minimalist, zero-config documentation generator for Node.js developers.</b>
+  <br>
+  Turn Markdown into beautiful, blazing-fast websites in seconds.
+  <br>
 </p>
 
 <p align="center">
-  <a href="https://www.npmjs.com/package/@mgks/docmd"><img src="https://img.shields.io/npm/v/@mgks/docmd.svg" alt="npm version"></a>
-  <a href="https://www.npmjs.com/package/@mgks/docmd"><img src="https://img.shields.io/npm/d18m/@mgks/docmd.svg" alt="npm downloads"></a>
-  <a href="https://github.com/mgks/docmd/blob/main/LICENSE"><img src="https://img.shields.io/github/license/mgks/docmd.svg" alt="license"></a>
+  <a href="https://www.npmjs.com/package/@mgks/docmd"><img src="https://img.shields.io/npm/v/@mgks/docmd.svg?style=flat-square&color=007acc" alt="npm version"></a>
+  <a href="https://www.npmjs.com/package/@mgks/docmd"><img src="https://img.shields.io/npm/dt/@mgks/docmd.svg?style=flat-square&color=success" alt="npm downloads"></a>
+  <a href="https://github.com/mgks/docmd/blob/main/LICENSE"><img src="https://img.shields.io/github/license/mgks/docmd.svg?style=flat-square&color=blue" alt="license"></a>
+  <a href="https://github.com/mgks/docmd/stargazers"><img src="https://img.shields.io/github/stars/mgks/docmd?style=flat-square&logo=github" alt="stars"></a>
 </p>
 
-Docmd is a Node.js command-line tool for generating fast, beautiful, and lightweight static documentation sites from standard Markdown files. It champions the philosophy of "zero clutter, just content," prioritizing a simple authoring experience and a clean, performant result for readers.
+<p align="center">
+  <a href="https://docmd.mgks.dev"><b>View Live Demo</b></a> • 
+  <a href="https://docmd.mgks.dev/getting-started/installation/"><b>Documentation</b></a> • 
+  <a href="https://github.com/mgks/docmd/issues"><b>Report Bug</b></a>
+</p>
+
+<br>
+
+<p align="center">
+  <img width="2856" height="1558" alt="519536477-8d948e18-8e2d-420d-8902-96e1aafab1ba-modified" src="https://github.com/user-attachments/assets/5b883c80-8357-46e8-9adb-84e38a0da64c" />
+  <sup><i>docmd noStyle page preview in dark mode</i></sup>
+</p>
 
-**:rocket: [Live Preview](https://docmd.mgks.dev): Official documentation site powered by `docmd`.**
+## 🚀 Why docmd?
 
-## Key Features
+Most documentation tools today are too heavy (React hydration, massive bundles) or require ecosystems you don't use (Python/Ruby).
 
--   **Markdown First:** Write your content in standard Markdown with simple YAML frontmatter.
--   **Beautiful Themes:** Comes with multiple built-in themes (`sky`, `ruby`, `retro`) and automatic light/dark mode support.
--   **Fast & Lightweight:** Blazing fast static site generation with a minimal client-side footprint.
--   **Rich Content:** Go beyond basic Markdown with custom components like callouts, cards, steps, tabs, and Mermaid diagrams.
--   **Built-in Plugins:** SEO meta tags, sitemap, and analytics are all included out-of-the-box.
--   **No-Style Pages:** Create completely custom pages (like landing pages) with full control over the HTML.
--   **Customizable:** Easily extend or override styles with your own CSS and JavaScript.
--   **Simple CLI:** A straightforward workflow with three main commands: `init`, `dev`, and `build`.
--   **Deploy Anywhere:** The generated `site/` folder can be hosted on any static web host (GitHub Pages, Netlify, Vercel, etc.).
+**docmd** fills the gap. It is a native Node.js tool that generates **pure, static HTML**.
 
-## Installation
-**Prerequisites:** [Node.js](https://nodejs.org/) (version 22.x or higher)
+*   ⚡ **Blazing Fast:** No hydration delay. Instant page loads.
+*   🛠 **Zero Config:** Works out of the box with sensible defaults.
+*   🎨 **Theming:** Built-in light/dark modes and multiple themes (`sky`, `ruby`, `retro`).
+*   📦 **Node.js Native:** No Python, no Gemfiles. Just `npm install`.
+*   🧩 **Rich Content:** Built-in support for Callouts, Cards, Tabs, Steps, and Changelogs.
 
-### Quick Start: Your First Site in 60 Seconds
+## 🏁 Quick Start
 
-No global installation is required. You can create and run your site in a new folder with one command.
+You don't need to install anything globally to try it out.
 
 ```bash
-# Create a new project in 'my-docs' and navigate into it
-npx @mgks/docmd init my-docs && cd my-docs
+# 1. Initialize a new project
+npx @mgks/docmd init my-docs
+
+# 2. Enter directory
+cd my-docs
 
-# Start the development server
+# 3. Start the dev server
 npm start
 ```
 
-Your new documentation site is now running at `http://localhost:3000` *(or, at your selected or available port)*.
+**Dev server output:**
+
+```
+                       
+     _                 _ 
+   _| |___ ___ _____ _| |
+  | . | . |  _|     | . |
+  |___|___|___|_|_|_|___|
+  
+   v0.x.x
+
+
+🚀 Performing initial build for dev server...
+✅ Generated sitemap at ./site/sitemap.xml
+✅ Initial build complete.
+👀 Watching for changes in:
+    - Source: ./docs
+    - Config: ./docmd.config.js
+    - Assets: ./assets
+    - docmd Templates: ./src/templates (internal)
+    - docmd Assets: ./src/assets (internal)
+🎉 Dev server started at http://localhost:3000
+Serving content from: ./site
+Live reload is active. Browser will refresh automatically when files change.
+```
+
+## ✨ Features
+
+| Feature | Description |
+| :--- | :--- |
+| **Markdown First** | Standard Markdown + Frontmatter. No proprietary syntax to learn. |
+| **Smart CLI** | Intelligent config validation catches typos before they break your build. |
+| **Custom Containers** | Use `::: callout`, `::: card`, `::: steps`, `::: tabs`, `::: collapsible`, `::: changelog`, and more to enrich content. |
+| **Diagrams** | Create flowcharts, relationship diagrams, journey, piecharts, graphs, timelines and more with Mermaid. |
+| **No-Style Pages** | Create custom landing pages (highly customizable custom HTML pages) without theme constraints. |
+| **Auto Dark Mode** | Respects system preference and saves user choice. |
+| **Plugins** | SEO, Sitemap, and Analytics support included out-of-the-box. |
+
+## 🆚 Comparison
+
+How does `docmd` stack up against the giants?
+
+| Feature | docmd | Docusaurus | MkDocs (Material) | Mintlify |
+| :--- | :--- | :--- | :--- | :--- |
+| **Language** | **Node.js** | React.js | Python | Proprietary |
+| **Output** | **Static HTML** | React SPA | Static HTML | Hosted / Next.js |
+| **JS Payload** | **Tiny (< 15kb)** | Heavy | Minimal | Medium |
+| **Setup** | **~2 mins** | ~15 mins | ~10 mins | Instant (SaaS) |
+| **Cost** | **100% Free OSS** | 100% Free OSS | 100% Free OSS | Freemium |
 
-### Global Installation
+👉 *[Read the full comparison](https://docmd.mgks.dev/comparison/)*
 
-For frequent use, or if you prefer to have the command available system-wide, you can install `docmd` globally using npm.
+## 📦 Installation
+
+For frequent use, install globally:
 
 ```bash
 npm install -g @mgks/docmd
 ```
-After installation, you can run the `docmd` commands from any directory.
-
-### Basic Workflow
 
-1.  **Initialize a Project:**
-    ```bash
-    docmd init
-    ```
-    This creates a `docs/` directory, a `docmd.config.js` file, and a sample `index.md` to get you started.
+### Commands
 
-2.  **Start the Dev Server:**
-    ```bash
-    docmd dev
-    ```
-    This starts a live-reloading server to preview your site as you write.
+*   `docmd init` - Create a new documentation project.
+*   `docmd dev` - Start the live-reloading local server.
+*   `docmd build` - Generate static files to `site/` for deployment.
 
-3.  **Build for Production:**
-    ```bash
-    docmd build
-    ```
-    This generates the complete, optimized static site into the `site/` directory, ready for deployment.
+## 🎨 Themes
 
-## Documentation
+Switching themes is as easy as changing one line in your `docmd.config.js`.
 
-For a complete guide covering all features, including theming, custom containers, and plugin configuration, please visit the official documentation website: **[docmd.mgks.dev](https://docmd.mgks.dev)**.
+```javascript
+module.exports = {
+  theme: {
+    name: 'sky', // Options: 'default', 'sky', 'ruby', 'retro'
+    defaultMode: 'dark'
+  }
+}
+```
 
-## Contributing
+## 🤝 Contributing
 
-We welcome contributions of all kinds! Whether it's reporting a bug, suggesting a feature, or submitting a pull request, your help is appreciated.
+We welcome contributions! Please see our [Contribution Guidelines](.github/CONTRIBUTING.md) for details.
 
 1.  Fork the repository.
-2.  Clone your fork: `git clone https://github.com/YOUR_USERNAME/docmd.git`
-3.  Install dependencies: `npm install`
-4.  Make your changes and test them thoroughly.
-5.  Submit a pull request to the `main` branch.
-
-Please check our [contributing guidelines](https://docmd.mgks.dev/contributing/) for more detailed information.
-
-## Support the Project
+2.  Create your feature branch (`git checkout -b feature/AmazingFeature`).
+3.  Commit your changes (`git commit -m 'Add some AmazingFeature'`).
+4.  Push to the branch (`git push origin feature/AmazingFeature`).
+5.  Open a Pull Request.
 
-If you find `docmd` useful, please consider:
+## ❤️ Support
 
--   Starring the repository on GitHub.
--   Sharing it with others who might benefit.
--   Reporting issues or submitting pull requests.
+This project is open source and free to use. If you find it valuable, please consider:
 
-❤️ **[GitHub Sponsors](https://github.com/sponsors/mgks): Become a sponsor to support the ongoing development of `docmd`.**
+1.  ⭐️ **Starring the repo** on GitHub (it helps a lot!)
+2.  ☕ **[Sponsoring the project](https://github.com/sponsors/mgks)** to support ongoing development.
 
-## License
+## 📄 License
 
-Docmd is licensed under the [MIT License](https://github.com/mgks/docmd/blob/main/LICENSE).
+Distributed under the MIT License. See `LICENSE` for more information.

package/config.js

@@ -123,6 +123,8 @@ module.exports = {
               { title: 'Cards', path: '/content/containers/cards', icon: 'panel-top' },
               { title: 'Steps', path: '/content/containers/steps', icon: 'list-ordered' },
               { title: 'Tabs', path: '/content/containers/tabs', icon: 'columns-3' },
+              { title: 'Collapsible', path: '/content/containers/collapsible', icon: 'chevrons-down' },
+              { title: 'Changelogs', path: '/content/containers/changelogs', icon: 'logs' },
               { title: 'Buttons', path: '/content/containers/buttons', icon: 'mouse-pointer-click' },
               { title: 'Nested Containers', path: '/content/containers/nested-containers', icon: 'folder-tree' },
             ]
@@ -155,9 +157,21 @@ module.exports = {
           { title: 'Sitemap', path: '/plugins/sitemap', icon: 'map' },
         ],
       },
+      {
+        title: 'Recipes',
+        icon: 'chef-hat',
+        path: '/recipes/',
+        collapsible: true,
+        children: [
+          { title: 'Landing Page', path: '/recipes/landing-page', icon: 'panel-top' },
+          { title: 'Custom Fonts', path: '/recipes/custom-fonts', icon: 'type-outline' },
+          { title: 'Favicon', path: '/recipes/favicon', icon: 'circle-dashed' },
+        ],
+      },
       { title: 'CLI Commands', path: '/cli-commands', icon: 'terminal' },
       { title: 'Deployment', path: '/deployment', icon: 'upload-cloud' },
       { title: 'Contributing', path: '/contributing', icon: 'users-2' },
+      { title: 'Comparison', path: '/comparison', icon: 'shapes' },
 
       { title: 'GitHub', path: 'https://github.com/mgks/docmd', icon: 'github', external: true },
       { title: 'Discussions', path: 'https://github.com/mgks/docmd/discussions', icon: 'message-square', external: true },