From fc4d766fd9b09e973b6831a72862baf2754475c6 Mon Sep 17 00:00:00 2001
From: Mauricio Siu <47042324+Siumauricio@users.noreply.github.com>
Date: Thu, 3 Apr 2025 00:26:57 -0600
Subject: [PATCH 1/5] chore: enhance README with new helper variables and add
 meta.json validation in CI workflow

---
 .github/workflows/validate.yml | 44 ++++++++++++++++++++++++++++++++++
 README.md                      |  4 +++-
 2 files changed, 47 insertions(+), 1 deletion(-)

diff --git a/.github/workflows/validate.yml b/.github/workflows/validate.yml
index cb8f737..cbb55bd 100644
--- a/.github/workflows/validate.yml
+++ b/.github/workflows/validate.yml
@@ -49,6 +49,50 @@ jobs:
             echo "✅ Blueprint folders validated successfully."
           fi
 
+      - name: Validate meta.json structure and required fields
+        run: |
+          echo "🔍 Validating meta.json structure and required fields..."
+
+          ERROR=0
+
+          # Validate JSON structure and required fields
+          ENTRIES=$(jq -c '.[]' meta.json)
+          INDEX=0
+          while IFS= read -r entry; do
+            ((INDEX++))
+            
+            # Validate required top-level fields
+            for field in "id" "name" "version" "description" "logo" "links" "tags"; do
+              if [ "$(echo "$entry" | jq "has(\"$field\")")" != "true" ]; then
+                echo "❌ Entry #$INDEX is missing required field: $field"
+                ERROR=1
+              fi
+            done
+
+            # Validate links object required fields
+            if [ "$(echo "$entry" | jq 'has("links")')" == "true" ]; then
+              for link_field in "github" "website" "docs"; do
+                if [ "$(echo "$entry" | jq ".links | has(\"$link_field\")")" != "true" ]; then
+                  echo "❌ Entry #$INDEX: links object is missing required field: $link_field"
+                  ERROR=1
+                fi
+              done
+            fi
+
+            # Validate tags array is not empty
+            if [ "$(echo "$entry" | jq '.tags | length')" -eq 0 ]; then
+              echo "❌ Entry #$INDEX: tags array cannot be empty"
+              ERROR=1
+            fi
+          done <<< "$ENTRIES"
+
+          if [ $ERROR -eq 1 ]; then
+            echo "❌ meta.json structure validation failed."
+            exit 1
+          else
+            echo "✅ meta.json structure validated successfully."
+          fi
+
       - name: Validate meta.json matches blueprint folders and logo files
         run: |
           echo "🔍 Validating meta.json against blueprint folders and logos..."
diff --git a/README.md b/README.md
index d9c80f4..fcb2886 100644
--- a/README.md
+++ b/README.md
@@ -131,7 +131,7 @@ My content
 """
 ```
 
-Important: you can reference any variable in the `domains`, `env` and `mounts` sections. just use the `${variable_name}` syntax, in the case you don't want to define a variable, you can use the `domain`, `base64`, `password`, `hash`, `uuid`, `randomPort` or `timestamp` helpers.
+Important: you can reference any variable in the `domains`, `env` and `mounts` sections. just use the `${variable_name}` syntax, in the case you don't want to define a variable, you can use the `domain`, `base64`, `password`, `hash`, `uuid`, `randomPort`, `timestamp`, `jwt`, `email`, or `username` helpers.
 
 ### Helpers
 
@@ -145,6 +145,8 @@ We have a few helpers that are very common when creating a template, these are:
 - `randomPort`: This is a helper that will generate a random port for the template.
 - `timestamp`: This is a helper that will generate a timestamp.
 - `jwt or jwt:length`: This is a helper that will generate a jwt for the template.
+- `email`: This is a helper that will generate a random email for the template.
+- `username`: This is a helper that will generate a random username in lowercase for the template.
 
 
 

From 38e0936ae57072093c2a1f301f2828e16663706a Mon Sep 17 00:00:00 2001
From: Mauricio Siu <47042324+Siumauricio@users.noreply.github.com>
Date: Thu, 3 Apr 2025 00:36:15 -0600
Subject: [PATCH 2/5] chore: add validation checks for meta.json in CI workflow

---
 .github/workflows/validate.yml | 19 +++++++++++++++++++
 1 file changed, 19 insertions(+)

diff --git a/.github/workflows/validate.yml b/.github/workflows/validate.yml
index cbb55bd..1a56227 100644
--- a/.github/workflows/validate.yml
+++ b/.github/workflows/validate.yml
@@ -53,13 +53,32 @@ jobs:
         run: |
           echo "🔍 Validating meta.json structure and required fields..."
 
+          # First check if meta.json exists and is valid JSON
+          if [ ! -f "meta.json" ]; then
+            echo "❌ meta.json file not found"
+            exit 1
+          fi
+
+          if ! jq empty meta.json 2>/dev/null; then
+            echo "❌ meta.json is not a valid JSON file"
+            exit 1
+          fi
+
           ERROR=0
 
+          # Debug: Show total number of entries
+          TOTAL_ENTRIES=$(jq '. | length' meta.json)
+          echo "📊 Total entries in meta.json: $TOTAL_ENTRIES"
+
           # Validate JSON structure and required fields
           ENTRIES=$(jq -c '.[]' meta.json)
           INDEX=0
           while IFS= read -r entry; do
             ((INDEX++))
+            echo "🔍 Checking entry #$INDEX..."
+            
+            # Debug: Show the current entry
+            echo "Current entry: $entry" | jq '.'
             
             # Validate required top-level fields
             for field in "id" "name" "version" "description" "logo" "links" "tags"; do

From 076c82490c70e6d387235e7d3bd8bb0f2dfe7786 Mon Sep 17 00:00:00 2001
From: Mauricio Siu <47042324+Siumauricio@users.noreply.github.com>
Date: Thu, 3 Apr 2025 00:38:14 -0600
Subject: [PATCH 3/5] chore: improve meta.json validation with detailed error
 reporting and debug output

---
 .github/workflows/validate.yml | 28 ++++++++++++++++++++--------
 1 file changed, 20 insertions(+), 8 deletions(-)

diff --git a/.github/workflows/validate.yml b/.github/workflows/validate.yml
index 1a56227..12a3545 100644
--- a/.github/workflows/validate.yml
+++ b/.github/workflows/validate.yml
@@ -51,6 +51,9 @@ jobs:
 
       - name: Validate meta.json structure and required fields
         run: |
+          set -x  # Enable debug mode to see all commands
+          exec 2>&1  # Redirect stderr to stdout to see all output
+
           echo "🔍 Validating meta.json structure and required fields..."
 
           # First check if meta.json exists and is valid JSON
@@ -65,25 +68,28 @@ jobs:
           fi
 
           ERROR=0
+          ERRORS_FOUND=""
 
           # Debug: Show total number of entries
           TOTAL_ENTRIES=$(jq '. | length' meta.json)
           echo "📊 Total entries in meta.json: $TOTAL_ENTRIES"
 
           # Validate JSON structure and required fields
-          ENTRIES=$(jq -c '.[]' meta.json)
-          INDEX=0
           while IFS= read -r entry; do
             ((INDEX++))
+            echo "-------------------------------------------"
             echo "🔍 Checking entry #$INDEX..."
             
-            # Debug: Show the current entry
-            echo "Current entry: $entry" | jq '.'
+            # Get the ID for better error reporting
+            ID=$(echo "$entry" | jq -r '.id // "UNKNOWN"')
+            echo "📝 Processing entry with ID: $ID"
             
             # Validate required top-level fields
             for field in "id" "name" "version" "description" "logo" "links" "tags"; do
               if [ "$(echo "$entry" | jq "has(\"$field\")")" != "true" ]; then
-                echo "❌ Entry #$INDEX is missing required field: $field"
+                ERROR_MSG="❌ Entry #$INDEX (ID: $ID) is missing required field: $field"
+                echo "$ERROR_MSG"
+                ERRORS_FOUND="$ERRORS_FOUND\n$ERROR_MSG"
                 ERROR=1
               fi
             done
@@ -92,7 +98,9 @@ jobs:
             if [ "$(echo "$entry" | jq 'has("links")')" == "true" ]; then
               for link_field in "github" "website" "docs"; do
                 if [ "$(echo "$entry" | jq ".links | has(\"$link_field\")")" != "true" ]; then
-                  echo "❌ Entry #$INDEX: links object is missing required field: $link_field"
+                  ERROR_MSG="❌ Entry #$INDEX (ID: $ID): links object is missing required field: $link_field"
+                  echo "$ERROR_MSG"
+                  ERRORS_FOUND="$ERRORS_FOUND\n$ERROR_MSG"
                   ERROR=1
                 fi
               done
@@ -100,13 +108,17 @@ jobs:
 
             # Validate tags array is not empty
             if [ "$(echo "$entry" | jq '.tags | length')" -eq 0 ]; then
-              echo "❌ Entry #$INDEX: tags array cannot be empty"
+              ERROR_MSG="❌ Entry #$INDEX (ID: $ID): tags array cannot be empty"
+              echo "$ERROR_MSG"
+              ERRORS_FOUND="$ERRORS_FOUND\n$ERROR_MSG"
               ERROR=1
             fi
-          done <<< "$ENTRIES"
+          done < <(jq -c '.[]' meta.json)
 
+          echo "-------------------------------------------"
           if [ $ERROR -eq 1 ]; then
             echo "❌ meta.json structure validation failed."
+            echo -e "Summary of all errors found:$ERRORS_FOUND"
             exit 1
           else
             echo "✅ meta.json structure validated successfully."

From 8069689a7388cd67f32179c9e20bad6e268c8b48 Mon Sep 17 00:00:00 2001
From: Mauricio Siu <47042324+Siumauricio@users.noreply.github.com>
Date: Thu, 3 Apr 2025 00:40:08 -0600
Subject: [PATCH 4/5] chore: streamline meta.json validation process by
 removing debug output and optimizing entry checks

---
 .github/workflows/validate.yml | 23 ++++++++++++-----------
 1 file changed, 12 insertions(+), 11 deletions(-)

diff --git a/.github/workflows/validate.yml b/.github/workflows/validate.yml
index 12a3545..48cfaa8 100644
--- a/.github/workflows/validate.yml
+++ b/.github/workflows/validate.yml
@@ -51,9 +51,6 @@ jobs:
 
       - name: Validate meta.json structure and required fields
         run: |
-          set -x  # Enable debug mode to see all commands
-          exec 2>&1  # Redirect stderr to stdout to see all output
-
           echo "🔍 Validating meta.json structure and required fields..."
 
           # First check if meta.json exists and is valid JSON
@@ -74,9 +71,13 @@ jobs:
           TOTAL_ENTRIES=$(jq '. | length' meta.json)
           echo "📊 Total entries in meta.json: $TOTAL_ENTRIES"
 
-          # Validate JSON structure and required fields
-          while IFS= read -r entry; do
-            ((INDEX++))
+          # Get all entries at once and process them
+          TOTAL_INDEX=$(($TOTAL_ENTRIES - 1))
+          
+          for i in $(seq 0 $TOTAL_INDEX); do
+            entry=$(jq -c ".[$i]" meta.json)
+            INDEX=$((i + 1))
+            
             echo "-------------------------------------------"
             echo "🔍 Checking entry #$INDEX..."
             
@@ -89,7 +90,7 @@ jobs:
               if [ "$(echo "$entry" | jq "has(\"$field\")")" != "true" ]; then
                 ERROR_MSG="❌ Entry #$INDEX (ID: $ID) is missing required field: $field"
                 echo "$ERROR_MSG"
-                ERRORS_FOUND="$ERRORS_FOUND\n$ERROR_MSG"
+                ERRORS_FOUND="${ERRORS_FOUND}${ERROR_MSG}\n"
                 ERROR=1
               fi
             done
@@ -100,7 +101,7 @@ jobs:
                 if [ "$(echo "$entry" | jq ".links | has(\"$link_field\")")" != "true" ]; then
                   ERROR_MSG="❌ Entry #$INDEX (ID: $ID): links object is missing required field: $link_field"
                   echo "$ERROR_MSG"
-                  ERRORS_FOUND="$ERRORS_FOUND\n$ERROR_MSG"
+                  ERRORS_FOUND="${ERRORS_FOUND}${ERROR_MSG}\n"
                   ERROR=1
                 fi
               done
@@ -110,15 +111,15 @@ jobs:
             if [ "$(echo "$entry" | jq '.tags | length')" -eq 0 ]; then
               ERROR_MSG="❌ Entry #$INDEX (ID: $ID): tags array cannot be empty"
               echo "$ERROR_MSG"
-              ERRORS_FOUND="$ERRORS_FOUND\n$ERROR_MSG"
+              ERRORS_FOUND="${ERRORS_FOUND}${ERROR_MSG}\n"
               ERROR=1
             fi
-          done < <(jq -c '.[]' meta.json)
+          done
 
           echo "-------------------------------------------"
           if [ $ERROR -eq 1 ]; then
             echo "❌ meta.json structure validation failed."
-            echo -e "Summary of all errors found:$ERRORS_FOUND"
+            echo -e "Summary of all errors found:${ERRORS_FOUND}"
             exit 1
           else
             echo "✅ meta.json structure validated successfully."

From 5a91d6ff8b8f0867cf262e88f82096fc521ef69b Mon Sep 17 00:00:00 2001
From: Mauricio Siu <47042324+Siumauricio@users.noreply.github.com>
Date: Thu, 3 Apr 2025 00:42:09 -0600
Subject: [PATCH 5/5] chore: add website links to various entries in meta.json
 for improved resource accessibility

---
 meta.json | 19 ++++++++++++-------
 1 file changed, 12 insertions(+), 7 deletions(-)

diff --git a/meta.json b/meta.json
index 080fa61..7bd2723 100644
--- a/meta.json
+++ b/meta.json
@@ -1,5 +1,4 @@
-[
-  {
+[  {
     "id": "appwrite",
     "name": "Appwrite",
     "version": "1.6.0",
@@ -1543,7 +1542,8 @@
     "logo": "it-tools.svg",
     "links": {
       "github": "https://github.com/CorentinTh/it-tools",
-      "website": "https://it-tools.tech"
+      "website": "https://it-tools.tech",
+      "docs": "https://it-tools.tech/docs"
     },
     "tags": [
       "developer",
@@ -1577,7 +1577,8 @@
     "logo": "glance.png",
     "links": {
       "github": "https://github.com/glanceapp/glance",
-      "docs": "https://github.com/glanceapp/glance/blob/main/docs/configuration.md"
+      "docs": "https://github.com/glanceapp/glance/blob/main/docs/configuration.md",
+      "website": "https://glance.app/"
     },
     "tags": [
       "dashboard",
@@ -2055,7 +2056,8 @@
     "logo": "logo.png",
     "links": {
       "github": "https://github.com/supernova3339/anonupload",
-      "docs": "https://github.com/Supernova3339/anonupload/blob/main/env.md"
+      "docs": "https://github.com/Supernova3339/anonupload/blob/main/env.md",
+      "website": "https://anonupload.com/"
     },
     "tags": [
       "file-sharing",
@@ -2172,7 +2174,9 @@
     "description": "Barrage is a minimalistic Deluge WebUI app with full mobile support. It features a responsive mobile-first design, allowing you to manage your torrents with ease from any device.",
     "logo": "logo.png",
     "links": {
-      "github": "https://github.com/maulik9898/barrage"
+      "github": "https://github.com/maulik9898/barrage",
+      "website": "https://github.com/maulik9898/barrage",
+      "docs": "https://github.com/maulik9898/barrage/blob/main/README.md"
     },
     "tags": [
       "torrents",
@@ -2443,7 +2447,8 @@
     "logo": "logo.png",
     "links": {
       "github": "https://github.com/linuxserver/docker-chromium",
-      "docs": "https://docs.linuxserver.io/images/docker-chromium"
+      "docs": "https://docs.linuxserver.io/images/docker-chromium",
+      "website": "https://docs.linuxserver.io/images/docker-chromium"
     },
     "tags": [
       "browser",