Update VERSION.md

Updates Signal Brand Color + Adds Alt
Merge pull request #151 from lllahaye/feature/Docker-support
2025-03-25 20:42:44 -04:00 · 2025-03-25 20:34:53 -04:00 · 2025-03-25 19:59:20 -04:00 · 2025-03-17 20:11:29 -04:00 · 2025-03-17 20:07:29 -04:00 · 2025-03-17 18:51:05 -04:00
15 changed files with 738 additions and 38 deletions
--- a/.devcontainer/devcontainer.json
+++ b/.devcontainer/devcontainer.json
@@ -1,28 +0,0 @@
-// For format details, see https://aka.ms/devcontainer.json. For config options, see the
-// README at: https://github.com/devcontainers/templates/tree/main/src/alpine
-{
-	"name": "Alpine",
-	// Or use a Dockerfile or Docker Compose file. More info: https://containers.dev/guide/dockerfile
-	"image": "mcr.microsoft.com/devcontainers/base:alpine",
-
-	// Features to add to the dev container. More info: https://containers.dev/features.
-	// "features": {},
-
-	// Use 'forwardPorts' to make a list of ports inside the container available locally.
-	// "forwardPorts": [],
-
-	// Use 'postCreateCommand' to run commands after the container is created.
-	// "postCreateCommand": "uname -a",
-
-	"customizations": {
-		// Configure properties specific to VS Code.
-		"vscode": {
-			"extensions": [
-				"ritwickdey.liveserver"
-			]
-		}
-	}
-
-	// Uncomment to connect as root instead. More info: https://aka.ms/dev-containers-non-root.
-	// "remoteUser": "root"
-}
--- a/.github/PULL_REQUEST_TEMPLATE.md
+++ b/.github/PULL_REQUEST_TEMPLATE.md
@@ -0,0 +1,42 @@
+## 📄 Description
+<!-- Provide a short description of the brand you're adding or the changes you're making. Include context about why this is a valuable addition. -->
+
+---
+
+## ✅ Contribution Checklist
+Please confirm that you've met the following criteria before submitting your contribution:
+
+- [ ] **Widespread Recognition:** The brand has widespread recognition and is suitable for the core LittleLink repository (most additions belong in [LittleLink Extended](https://github.com/sethcottle/littlelink-extended)).  
+- [ ] **Brand Styling Guidelines:** You’ve followed the brand's official styling guidelines (if available).  
+- [ ] **Consistent Styling:** If no guidelines exist, the button style is consistent with the brand's public image (e.g., website, social media).  
+- [ ] **Icon Clarity:** The brand's logo/icon is clear and recognizable in a 24x24px format.  
+   - [ ] If the primary logo doesn’t scale well, you’ve adapted it using the brand’s social media avatar or favicon while maintaining the essence of the original logo.  
+   - [ ] The icon is provided in `.svg` format.  
+- [ ] **Theme Testing:** You've tested the button against both light and dark themes:  
+   - [ ] Manually swapped `theme-auto.css` with `theme-light.css` and `theme-dark.css` in `index.html` to check contrast or used [LittleLink Button Builder](https://builder.littlelink.io) contrast checker.
+   - [ ] Added a `#000000`/`#FFFFFF` stroke if necessary to improve contrast and accessibility. [LittleLink Button Builder](https://builder.littlelink.io) will automatically recommend when to add a stroke.  
+- [ ] **Accessibility Compliance:** The button's background and text colors meet visual accessibility standards (unless it contradicts brand guidelines).  
+- [ ] **Alphabetical Order:** Your contribution is alphabetically organized in `brands.css` and `index.html`.  
+- [ ] **Button Preview:** You've added a button preview in `index.html`.  
+- [ ] **Variant Naming Schema:** If adding a variant button (e.g., inverted color scheme):  
+   - [ ] Naming follows the existing pattern (`[Brand Name] Alt` and `.button-brandname-alt`).  
+   - [ ] Any additional icons are named according to `brandname-alt.svg` schema.  
+- [ ] **Proper Capitalization:**  
+   - [ ] In `brands.css`, the brand name comment follows `/* Brand Name */` format.  
+   - [ ] Code uses lowercase for `.button.button-brandname`.  
+   - [ ] In `index.html`, comments reflect `<!-- Brand Name -->` format.  
+   - [ ] Button text and `alt` attributes match the brand’s official capitalization.  
+- [ ] **PR Details:**  
+   - [ ] Included a brief description of the brand addition.
+   - [ ] Included a screenshot of the new button(s).  
+   - [ ] Provided relevant information on the brand’s global/regional reach or usage stats.  
+
+---
+
+## 📸 Screenshot  
+<!-- Attach a screenshot of the new button(s) to ensure consistency and clarity. -->
+
+---
+
+## 🚀 Additional Notes  
+<!-- Add any other information that might help the reviewer understand the changes better (e.g., source of logo, special handling, etc.). -->
--- a/.github/workflows/contrast-check.yml
+++ b/.github/workflows/contrast-check.yml
@@ -0,0 +1,242 @@
+name: "Contrast Check"
+on:
+  pull_request:
+    paths:
+      - 'css/brands.css'
+  workflow_dispatch:  # Manual trigger for testing
+
+jobs:
+  contrast-check:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v3
+        with:
+          fetch-depth: 0
+          
+      - name: Setup for PR comparison
+        run: |
+          echo "Fetching base branch for comparison"
+          git fetch origin ${{ github.base_ref }}
+          
+      - name: Contrast Check (Review Me)
+        run: |
+          cat > contrast-check.sh << 'EOF'
+          #!/bin/bash
+          
+          # WCAG Minimum Contrast Ratio
+          MIN_CONTRAST=4.5
+          
+          FAILED=0
+          ALL_RESOLVED=1
+          NEEDS_MANUAL_REVIEW=0
+          
+          # Only get buttons that were modified in the PR
+          echo "Finding changed button styles..."
+          BUTTON_CLASSES=$(git diff origin/$GITHUB_BASE_REF -- css/brands.css | grep -E "^\+.*\.button-[a-zA-Z0-9]+" | sed -E 's/.*\.button-([a-zA-Z0-9]+).*/\1/' | sort -u)
+          
+          if [[ -z "$BUTTON_CLASSES" ]]; then
+            echo "✅ No button changes to check."
+            exit 0
+          fi
+          
+          echo "Found button classes to check: $BUTTON_CLASSES"
+          echo "🔍 Auditing CSS for contrast issues..."
+          
+          # Function to normalize hex colors to lowercase
+          normalize_color() {
+              local color="$1"
+              if [[ -n "$color" ]]; then
+                  echo "$color" | tr '[:upper:]' '[:lower:]'
+              else
+                  echo ""
+              fi
+          }
+          
+          # Function to calculate luminance
+          get_luminance() {
+              local color="$1"
+              
+              if [[ -z "$color" || "$color" == "#" ]]; then
+                  echo 0
+                  return
+              fi
+              
+              color="${color#'#'}"
+              
+              if [[ ${#color} -ne 6 ]]; then
+                  echo 0
+                  return
+              fi
+              
+              r=$(printf "%d" 0x${color:0:2} 2>/dev/null || echo 0)
+              g=$(printf "%d" 0x${color:2:2} 2>/dev/null || echo 0)
+              b=$(printf "%d" 0x${color:4:2} 2>/dev/null || echo 0)
+              
+              r=$(awk "BEGIN { print ($r/255 <= 0.03928) ? ($r/255)/12.92 : ((($r/255) + 0.055)/1.055) ^ 2.4 }")
+              g=$(awk "BEGIN { print ($g/255 <= 0.03928) ? ($g/255)/12.92 : ((($g/255) + 0.055)/1.055) ^ 2.4 }")
+              b=$(awk "BEGIN { print ($b/255 <= 0.03928) ? ($b/255)/12.92 : ((($b/255) + 0.055)/1.055) ^ 2.4 }")
+              
+              echo $(awk "BEGIN { print (0.2126 * $r) + (0.7152 * $g) + (0.0722 * $b) }")
+          }
+          
+          # Function to calculate contrast ratio
+          get_contrast_ratio() {
+              local lum1=$(get_luminance "$1")
+              local lum2=$(get_luminance "$2")
+          
+              if [[ -z "$lum1" || -z "$lum2" ]]; then
+                  echo 0
+                  return
+              fi
+          
+              if (( $(awk "BEGIN { print ($lum1 > $lum2) ? 1 : 0 }") )); then
+                  awk "BEGIN { printf \"%.5f\", ($lum1 + 0.05) / ($lum2 + 0.05) }"
+              else
+                  awk "BEGIN { printf \"%.5f\", ($lum2 + 0.05) / ($lum1 + 0.05) }"
+              fi
+          }
+          
+          # Function to extract hex color
+          extract_color() {
+              local input="$1"
+              local color=""
+              
+              if [[ "$input" =~ "#[0-9a-fA-F]{6}" ]]; then
+                  color=$(echo "$input" | grep -o "#[0-9a-fA-F]\{6\}")
+              elif [[ "$input" =~ "1px solid #" ]]; then
+                  color=$(echo "$input" | sed -E 's/.*1px solid (#[0-9a-fA-F]{6}).*/\1/')
+              elif [[ "$input" =~ "solid #" ]]; then
+                  color=$(echo "$input" | sed -E 's/.*solid (#[0-9a-fA-F]{6}).*/\1/')
+              elif [[ "$input" =~ "#" ]]; then
+                  color=$(echo "$input" | grep -o "#[0-9a-fA-F]*" | head -1)
+              fi
+              
+              # Return normalized (lowercase) hex color
+              normalize_color "$color"
+          }
+          
+          # Check contrast
+          check_contrast() {
+              local text_color="$1"
+              local background_color="$2"
+              local context="$3"
+              local border_color="$4"
+              local recommend_stroke="$5"
+              local is_background_check="$6"
+              local button_name="$7"
+              local check_failed=0
+              
+              # Normalize all colors to lowercase for comparison
+              text_color=$(normalize_color "$text_color")
+              background_color=$(normalize_color "$background_color")
+              border_color=$(normalize_color "$border_color")
+              recommend_stroke=$(normalize_color "$recommend_stroke")
+              
+              if [[ -z "$text_color" || -z "$background_color" ]]; then
+                  return 0
+              fi
+          
+              local contrast_ratio=$(get_contrast_ratio "$text_color" "$background_color")
+          
+              if [[ -z "$contrast_ratio" ]]; then
+                  contrast_ratio=0
+              fi
+          
+              contrast_ratio=$(printf "%.2f" "$contrast_ratio")
+          
+              # Case-insensitive comparison for hex colors
+              if (( $(awk "BEGIN { print ($contrast_ratio < $MIN_CONTRAST) ? 1 : 0 }") )); then
+                  if [[ -n "$border_color" && "$border_color" == "$recommend_stroke" && "$is_background_check" -eq 1 ]]; then
+                      echo "✅ [$context → $button_name] Contrast ratio $contrast_ratio fails WCAG but has a $recommend_stroke border → Treated as passing."
+                      echo "✅ [$context → $button_name] Issue resolved by stroke → Fully passing."
+                      check_failed=0
+                  else
+                      echo "❌ [$context → $button_name] Contrast ratio $contrast_ratio fails WCAG — Recommend adding a $recommend_stroke stroke."
+                      check_failed=1
+                  fi
+              else
+                  echo "✅ [$context → $button_name] Contrast ratio $contrast_ratio passes WCAG"
+                  check_failed=0
+              fi
+              
+              return $check_failed
+          }
+          
+          # For each button class, check its properties
+          for button_class in $BUTTON_CLASSES; do
+              echo "Checking button: $button_class"
+              
+              # Extract button section
+              # Avoid partial matches
+              button_start=$(grep -n "\.button-$button_class\( \|{\)" css/brands.css | cut -d: -f1)
+              if [[ -z "$button_start" ]]; then
+                  button_start=$(grep -n "\.button-$button_class$" css/brands.css | cut -d: -f1)
+              fi
+              
+              if [[ -z "$button_start" ]]; then
+                  echo "Could not find button-$button_class in css/brands.css"
+                  continue
+              fi
+              
+              # Look for the next closing bracket
+              button_end=$(tail -n +$button_start css/brands.css | grep -n "}" | head -1 | cut -d: -f1)
+              if [[ -z "$button_end" ]]; then
+                  button_end=10
+              fi
+              
+              button_section=$(tail -n +$button_start css/brands.css | head -n $button_end)
+              
+              # Check for gradient
+              if echo "$button_section" | grep -q "background-image"; then
+                  echo "🚩 [./css/brands.css → $button_class] Detected gradient background → Flagging for manual review."
+                  NEEDS_MANUAL_REVIEW=1
+                  continue
+              fi
+              
+              # Extract colors
+              text_color=$(echo "$button_section" | grep "button-text" | grep -o "#[0-9A-Fa-f]*")
+              bg_color=$(echo "$button_section" | grep "button-background" | grep -o "#[0-9A-Fa-f]*")
+              border_color=$(extract_color "$(echo "$button_section" | grep "button-border")")
+              
+              button_failed=0
+              
+              # Check text vs background
+              if [[ -n "$text_color" && -n "$bg_color" ]]; then
+                  check_contrast "$text_color" "$bg_color" "TEXT vs BUTTON" "$border_color" "" 0 "$button_class"
+                  button_failed=$((button_failed | $?))
+              fi
+              
+              # Check button vs light theme
+              if [[ -n "$bg_color" ]]; then
+                  check_contrast "#ffffff" "$bg_color" "BUTTON vs LIGHT THEME" "$border_color" "#000000" 1 "$button_class"
+                  button_failed=$((button_failed | $?))
+                  
+                  # Check button vs dark theme
+                  check_contrast "#121212" "$bg_color" "BUTTON vs DARK THEME" "$border_color" "#ffffff" 1 "$button_class"
+                  button_failed=$((button_failed | $?))
+              fi
+              
+              if [[ $button_failed -eq 1 ]]; then
+                  FAILED=1
+                  ALL_RESOLVED=0
+              fi
+          done
+          
+          # Final report
+          if [[ "$NEEDS_MANUAL_REVIEW" -eq 1 ]]; then
+              echo "⚠️ Manual review required for gradients!"
+              exit 1
+          elif [[ "$ALL_RESOLVED" -eq 1 ]]; then
+              echo "✅ All contrast checks passed!"
+              exit 0
+          else
+              echo "❌ Contrast issues found!"
+              exit 1
+          fi
+          EOF
+          
+          chmod +x contrast-check.sh
+          ./contrast-check.sh
+        env:
+          GITHUB_BASE_REF: ${{ github.base_ref }}
--- a/README.md
+++ b/README.md
@@ -65,19 +65,21 @@ Duplicate the [LittleLink Template on Figma Community](https://www.figma.com/com
 ### 💖 Supporters
 You can support LittleLink by [buying me a coffee](https://www.buymeacoffee.com/seth). You can also have your name or your company added to this section and the supporters page of the [LittleLink.io](https://littlelink.io) website.

-#### 🏢 Business Supporters
+#### 🏢 Business Supporters ($75 tier)
 • **[links.dev](https://github.com/fatih-yavuz/links.dev)**

 [![Add Your Company Name](https://cdn.cottle.cloud/littlelink/button-buy-me-a-coffee-company.svg)](https://www.buymeacoffee.com/seth/e/50574)

-#### ✨ Individual Supporters
+#### ✨ Individual Supporters ($25 tier)
 • **[Drew Davis](https://connect.davisdre.me)**

 • **[Robotter112](https://robotter112.de/)**

 [![Buy Me A Coffee](https://cdn.cottle.cloud/littlelink/button-buy-me-a-coffee-individual.svg)](https://www.buymeacoffee.com/seth/e/50573)

-#### 🐙 GitHub Sponsors
+#### 🐙 Active GitHub Sponsors
+• **[@nghialele](https://github.com/nghialele)**
+
 • **[Your Name Here](https://github.com/sponsors/sethcottle)**

 [![GitHub Sponsors](https://cdn.cottle.cloud/littlelink/button-github-sponsors.svg)](https://github.com/sponsors/sethcottle)
@@ -97,6 +99,14 @@ You can support LittleLink by [buying me a coffee](https://www.buymeacoffee.com/

 ---

+### 🆕 Stay Connected
+
+Join the [Seth's Nook Discord](https://discord.gg/PrAEQFF2fK) server to get updates on LittleLink and more. Use the invite code `PrAEQFF2fK` or click the button below.
+
+[![Discord](https://cdn.cottle.cloud/littlelink/button-discord.svg)](https://discord.gg/PrAEQFF2fK)
+
+---
+
 ### 📊 Analytics

 To help build a more privacy focused product, we recommend using [Fathom Analytics](https://usefathom.com/ref/EQVZMV)*. [View our Fathom analytics dashboard](https://app.usefathom.com/share/xbmnwxxl/littlelink.io#/?filters=%5B%5D&range=last_7_days&site=2251799827005303)**.
@@ -106,3 +116,19 @@ To help build a more privacy focused product, we recommend using [Fathom Analyti
 ###### ** Analytics in this dashboard start May 03, 2022. View this [Google Sheets file](https://docs.google.com/spreadsheets/d/1GL4SroAdH-OZphBVR5z-BoSukHIEVJfao25q_e9-Ii8/edit?usp=sharing) with the generic unique pageview data from Google Analytics.

 [![Fathom](https://cdn.cottle.cloud/littlelink/button-fathom-analytics.svg)](https://usefathom.com/ref/EQVZMV)
+
+---
+### 🐳 Docker Support
+LittleLink includes Docker support for easy deployment and development. All Docker-related files are located in the `docker/` directory.
+
+To run LittleLink using Docker:
+
+```bash
+docker compose -f docker/compose.yaml up
+```
+
+This will make the site available at http://localhost:8080
+
+For more information about Docker configuration, see [docker/README.md](docker/README.md).
+
+---
--- a/VERSION.md
+++ b/VERSION.md
@@ -1,6 +1,23 @@
 # LittleLink Version History

-## Current Version: v3.2.0
+## Current Version: v3.6.0
+
+### v3.6.0 - 3/25/2025
+- Finally adds Docker support to LittleLink. See [PR #151](https://github.com/sethcottle/littlelink/pull/151), thank you [@lllahaye](https://github.com/lllahaye).
+  - Docker support has been a long-standing community request. While I previously closed similar PRs in an effort to keep the LittleLink repo as minimal as possible, several community forks emerged that added Docker support independently. Over the last few weeks I had been reconsidering this stance—this PR arrived at just the right time.
+- Updated the brand color for Signal.
+
+### v3.5.0 - 3/10/2025
+- Added LittleLink Extended information in `index.html`
+- Added `PULL_REQUEST_TEMPLATE.md` to `.github` which is a reflection of [submitting a new brand](https://github.com/sethcottle/littlelink/wiki/Submitting-a-new-brand-to-LittleLink) wiki.
+
+### v3.4.0 - 3/04/2025
+- Added Matrix
+  
+### v3.3.0 - 03/01/2025
+- Updated Facebook Logo
+- Updated Messenger Logo
+- Updated Messenger Button Color

 ### v3.2.0 - 2/14/2025
 - Added Apple Invites
--- a/css/brands.css
+++ b/css/brands.css
@@ -185,13 +185,13 @@
 /* Facebook */
 .button-faceb {
 	--button-text:#ffffff;
-	--button-background:#1877f2;
+	--button-background:#0866FF;
 }

 /* Facebook Messenger */
 .button-messenger {
 	--button-text:#ffffff;
-	background-image:linear-gradient(25deg,#0099ff,#5f5dff,#a033ff,#c740cc,#ff5280,#ff7061);
+	--button-background:#0866FF;
 }

 /* Figma */
@@ -345,6 +345,13 @@
 	--button-border:1px solid #FFFFFF;
 }

+/* Matrix */
+.button-matrix {
+	--button-text:#000000;
+	--button-background:#ffffff;
+	--button-border:1px solid #000000;
+}
+
 /* Medium */
 .button-medium {
 	--button-text:#ffffff;
@@ -422,7 +429,14 @@
 /* Signal */
 .button-signal {
 	--button-text:#ffffff;
-	--button-background:#3a76f0;
+	--button-background:#3B45FD;
+}
+
+/* Signal Alt */
+.button-signal-alt {
+	--button-text:#3B45FD;
+	--button-background:#E3E8FE;
+	--button-border:1px solid #000000;
 }

 /* Slack */
--- a/docker/.dockerignore
+++ b/docker/.dockerignore
@@ -0,0 +1,46 @@
+# Include any files or directories that you don't want to be copied to your
+# container here (e.g., local build artifacts, temporary files, etc.).
+#
+# For more help, visit the .dockerignore file reference guide at
+# https://docs.docker.com/go/build-context-dockerignore/
+
+# Git
+.git
+.github
+.gitignore
+
+# Docker
+.dockerignore
+docker-compose*
+compose.yaml
+
+# Logs
+*.log
+
+# Editor directories and files
+.idea
+.vscode
+**/.DS_Store
+
+# Documentation files
+README*
+LICENSE*
+VERSION*
+CONTRIBUTING*
+
+# Exclude unnecessary files
+**/__pycache__
+**/.venv
+**/bin
+**/obj
+**/charts
+**/.env
+**/secrets.dev.yaml
+**/values.dev.yaml
+
+# Keep only essential files for the static website
+!index.html
+!privacy.html
+!css/
+!images/
+!fonts/
--- a/docker/Dockerfile
+++ b/docker/Dockerfile
@@ -0,0 +1,35 @@
+FROM nginx:alpine
+
+# Copy static website files
+COPY . /usr/share/nginx/html/
+
+# Configure nginx with basic optimization and logging to stdout/stderr
+RUN echo 'server { \
+    listen 80; \
+    server_name localhost; \
+    root /usr/share/nginx/html; \
+    index index.html index.htm; \
+    \
+    # Enable access logging to stdout \
+    access_log /dev/stdout; \
+    error_log /dev/stderr; \
+    \
+    # Enable gzip compression \
+    gzip on; \
+    gzip_vary on; \
+    gzip_types text/plain text/css application/json application/javascript; \
+    \
+    # Basic cache settings \
+    location ~* \\.(?:css|js|jpg|jpeg|gif|png|ico|svg)$ { \
+        expires 7d; \
+        add_header Cache-Control "public"; \
+    } \
+}' > /etc/nginx/conf.d/default.conf
+
+# Forward nginx logs to Docker log collector
+RUN ln -sf /dev/stdout /var/log/nginx/access.log && \
+    ln -sf /dev/stderr /var/log/nginx/error.log
+
+EXPOSE 80
+
+CMD ["nginx", "-g", "daemon off;"]
--- a/docker/README.md
+++ b/docker/README.md
@@ -0,0 +1,231 @@
+# Docker for LittleLink
+
+Docker configuration to run LittleLink in a container.
+
+## File Structure
+
+- `Dockerfile`: Defines how the image is built using nginx:alpine
+- `compose.yaml`: Configuration for Docker Compose with volumes for development
+- `.dockerignore`: Excludes unnecessary files from the image
+
+## Technical Details
+
+### Base Image
+- Uses `nginx:alpine` for minimal image size (~20MB)
+- Includes gzip compression for static files
+- Optimized cache configuration for CSS, JavaScript, and images
+- Configured to forward nginx logs to Docker log collector
+
+### Volumes and Ports
+- Mounts the project root directory as a volume for live development
+- Exposes port 80 in the container, mapped to 8080 on the host
+
+## Common Use Cases
+
+### Creating Personal Link Pages for Different People
+
+One of the main advantages of this Docker setup is how easily you can create multiple personalized instances of LittleLink:
+
+```bash
+# Clone the repository
+git clone https://github.com/sethcottle/littlelink.git littlelink-john
+
+# Customize the content for John
+cd littlelink-john
+# Edit index.html with John's links, customize images, etc.
+
+# Build a Docker image for John's page
+docker build -f docker/Dockerfile -t littlelink-john .
+
+# Run John's page on port 8080
+docker run -d --name john-links -p 8080:80 littlelink-john
+```
+
+For additional pages:
+
+```bash
+# Similarly for another person
+git clone https://github.com/sethcottle/littlelink.git littlelink-jane
+cd littlelink-jane
+# Customize for Jane...
+
+# Build and run on a different port
+docker build -f docker/Dockerfile -t littlelink-jane .
+docker run -d --name jane-links -p 8081:80 littlelink-jane
+```
+
+This approach allows you to:
+- Maintain separate customized sites for different people
+- Run multiple instances on different ports
+- Update each site independently
+- Easily deploy to various environments
+
+## Development vs. Production
+
+There are two main ways to use Docker with LittleLink:
+
+### Development Workflow
+
+In development, we use Docker Compose with mounted volumes to allow for live editing:
+
+```bash
+# Start development environment
+docker compose -f docker/compose.yaml up
+```
+
+This configuration:
+- Mounts local files as a volume, so changes are reflected immediately
+- Requires manual browser refresh to see changes
+- Is ideal for testing and development
+
+### Production Workflow
+
+For production, you have two options:
+
+#### Option 1: Production with Docker Compose
+
+Create a production-specific docker-compose file:
+
+```yaml
+# docker/compose.prod.yaml
+
+services:
+  web:
+    image: yourname/littlelink:latest
+    restart: always
+    ports:
+      - "8080:80"
+    # Optional volume for customizable content
+    volumes:
+      - /path/on/server/custom-content:/usr/share/nginx/html
+```
+
+Deploy using:
+
+```bash
+# Build and tag the image
+docker build -f docker/Dockerfile -t yourname/littlelink:latest .
+
+# Run in production with compose
+docker compose -f docker/compose.prod.yaml up -d
+```
+
+#### Option 2: Production with Docker Run
+
+```bash
+# Build a production image
+docker build -f docker/Dockerfile -t yourname/littlelink:latest .
+
+# Run in production (no volumes mounted)
+docker run -d --name littlelink -p 80:80 --restart always yourname/littlelink:latest
+```
+
+## Using Volumes in Production
+
+You can customize the content in production by mounting a local directory:
+
+```bash
+# Prepare a directory with your custom content
+mkdir -p /path/on/server/custom-content
+cp -r index.html css/ images/ /path/on/server/custom-content/
+
+# Run with the custom content mounted
+docker run -d --name littlelink -p 80:80 \
+  -v /path/on/server/custom-content:/usr/share/nginx/html \
+  yourname/littlelink:latest
+```
+
+With Docker Compose:
+
+```yaml
+services:
+  web:
+    image: yourname/littlelink:latest
+    ports:
+      - "80:80"
+    volumes:
+      - /path/on/server/custom-content:/usr/share/nginx/html
+```
+
+This approach:
+- Allows content customization without rebuilding the image
+- Makes it easy to update content independently of the container
+
+## Docker Commands Reference
+
+### Development Commands
+
+```bash
+# Start in development mode
+docker compose -f docker/compose.yaml up
+
+# Start in background
+docker compose -f docker/compose.yaml up -d
+
+# Stop container
+docker compose -f docker/compose.yaml down
+
+# View logs (including HTTP request logs)
+docker compose -f docker/compose.yaml logs -f
+```
+
+### Production Commands
+
+```bash
+# Build production image
+docker build -f docker/Dockerfile -t yourname/littlelink:latest .
+
+# Run production container
+docker run -d --name littlelink -p 80:80 yourname/littlelink:latest
+
+# View logs for the running container
+docker logs -f littlelink
+```
+
+## Customization
+
+### Change Port
+Edit `docker/compose.yaml` for development:
+```yaml
+ports:
+  - "8081:80"  # Change 8080 to desired port
+```
+
+Or specify port when running production container:
+```bash
+docker run -p 8081:80 yourname/littlelink:latest
+```
+
+### Additional nginx Configuration
+To modify the nginx configuration, you can edit the `Dockerfile` and add your own configuration:
+
+```dockerfile
+# Example: add custom configuration
+COPY docker/nginx.conf /etc/nginx/conf.d/default.conf
+```
+
+## Deploying to Production
+
+### Docker on VPS
+```bash
+# Pull image
+docker pull yourname/littlelink:latest
+
+# Run container
+docker run -d --name littlelink -p 80:80 yourname/littlelink:latest
+
+# With restart policy for auto-recovery
+docker run -d --name littlelink --restart unless-stopped -p 80:80 yourname/littlelink:latest
+```
+
+### Multiple Sites on One Server
+You can run multiple LittleLink instances on the same server:
+
+```bash
+# Run first site on port 8080
+docker run -d --name site1 -p 8080:80 littlelink-site1
+
+# Run second site on port 8081
+docker run -d --name site2 -p 8081:80 littlelink-site2
+```
+
--- a/docker/compose.yaml
+++ b/docker/compose.yaml
@@ -0,0 +1,10 @@
+services:
+  web:
+    build:
+      context: ..
+      dockerfile: docker/Dockerfile
+    ports:
+      - "8080:80"
+    volumes:
+      - ..:/usr/share/nginx/html
+    restart: unless-stopped
--- a/images/icons/facebook.svg
+++ b/images/icons/facebook.svg
@@ -1 +1,10 @@
-<svg fill="none" height="24" viewBox="0 0 24 24" width="24" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink"><clipPath id="a"><path d="m0 0h24v24h-24z"/></clipPath><g clip-path="url(#a)"><path d="m23.625 12c0-6.42188-5.2031-11.625-11.625-11.625-6.42188 0-11.625 5.20312-11.625 11.625 0 5.8022 4.25109 10.6116 9.8086 11.4844v-8.1239h-2.95313v-3.3605h2.95313v-2.56125c0-2.91328 1.7344-4.5225 4.3908-4.5225 1.2722 0 2.6025.22688 2.6025.22688v2.85937h-1.4663c-1.4437 0-1.8942.89625-1.8942 1.81547v2.18203h3.2241l-.5157 3.3605h-2.7084v8.1239c5.5575-.8728 9.8086-5.6822 9.8086-11.4844z" fill="#fff"/></g></svg>
+<svg width="24" height="24" viewBox="0 0 24 24" fill="none" xmlns="http://www.w3.org/2000/svg">
+<g clip-path="url(#clip0_4_34)">
+<path d="M24 12C24 5.37264 18.6274 0 12 0C5.37264 0 0 5.37264 0 12C0 17.6275 3.87456 22.3498 9.10128 23.6467V15.6672H6.62688V12H9.10128V10.4198C9.10128 6.33552 10.9498 4.4424 14.9597 4.4424C15.72 4.4424 17.0318 4.59168 17.5685 4.74048V8.06448C17.2853 8.03472 16.7933 8.01984 16.1822 8.01984C14.2147 8.01984 13.4544 8.76528 13.4544 10.703V12H17.3741L16.7006 15.6672H13.4544V23.9122C19.3963 23.1946 24.0005 18.1354 24.0005 12H24Z" fill="white"/>
+</g>
+<defs>
+<clipPath id="clip0_4_34">
+<rect width="24" height="24" fill="white"/>
+</clipPath>
+</defs>
+</svg>
--- a/images/icons/matrix.svg
+++ b/images/icons/matrix.svg
@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!-- Generator: Adobe Illustrator 19.1.0, SVG Export Plug-In . SVG Version: 6.00 Build 0)  -->
+<svg version="1.1" id="Layer_1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" x="0px" y="0px" viewBox="0 0 520 520" style="enable-background:new 0 0 520 520;" xml:space="preserve">
+<path d="M13.7,11.9v496.2h35.7V520H0V0h49.4v11.9H13.7z"/>
+<path d="M166.3,169.2v25.1h0.7c6.7-9.6,14.8-17,24.2-22.2c9.4-5.3,20.3-7.9,32.5-7.9c11.7,0,22.4,2.3,32.1,6.8  c9.7,4.5,17,12.6,22.1,24c5.5-8.1,13-15.3,22.4-21.5c9.4-6.2,20.6-9.3,33.5-9.3c9.8,0,18.9,1.2,27.3,3.6c8.4,2.4,15.5,6.2,21.5,11.5  c6,5.3,10.6,12.1,14,20.6c3.3,8.5,5,18.7,5,30.7v124.1h-50.9V249.6c0-6.2-0.2-12.1-0.7-17.6c-0.5-5.5-1.8-10.3-3.9-14.3  c-2.2-4.1-5.3-7.3-9.5-9.7c-4.2-2.4-9.9-3.6-17-3.6c-7.2,0-13,1.4-17.4,4.1c-4.4,2.8-7.9,6.3-10.4,10.8c-2.5,4.4-4.2,9.4-5,15.1  c-0.8,5.6-1.3,11.3-1.3,17v103.3h-50.9v-104c0-5.5-0.1-10.9-0.4-16.3c-0.2-5.4-1.3-10.3-3.1-14.9c-1.8-4.5-4.8-8.2-9-10.9  c-4.2-2.7-10.3-4.1-18.5-4.1c-2.4,0-5.6,0.5-9.5,1.6c-3.9,1.1-7.8,3.1-11.5,6.1c-3.7,3-6.9,7.3-9.5,12.9c-2.6,5.6-3.9,13-3.9,22.1  v107.6h-50.9V169.2H166.3z"/>
+<path d="M506.3,508.1V11.9h-35.7V0H520v520h-49.4v-11.9H506.3z"/>
+</svg>
--- a/images/icons/messenger.svg
+++ b/images/icons/messenger.svg
@@ -1 +1,10 @@
-<svg fill="none" height="24" viewBox="0 0 24 24" width="24" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink"><clipPath id="a"><path d="m0 0h24v24h-24z"/></clipPath><g clip-path="url(#a)"><path clip-rule="evenodd" d="m0 11.64c0-6.68831 5.24005-11.64 12-11.64 6.76 0 12 4.95169 12 11.64 0 6.6884-5.24 11.64-12 11.64-1.2142 0-2.3791-.1603-3.47362-.4612-.21276-.0586-.43901-.042-.64093.047l-2.38183 1.0514c-.62304.2751-1.32634-.168-1.34722-.8488l-.06535-2.1346c-.00804-.263-.12636-.5088-.32237-.6842-2.33492-2.0881-3.76868-5.1111-3.76868-8.6096zm8.31906-2.1884-3.525 5.5925c-.33828.5367.32143 1.1415.8268.758l3.78644-2.8737c.25613-.1944.6101-.1954.8673-.0025l2.8037 2.1028c.8412.631 2.042.4094 2.6027-.4802l3.525-5.59255c.3382-.53671-.3214-1.14151-.8268-.75799l-3.7865 2.87364c-.2561.1944-.61.1954-.8673.0025l-2.8036-2.10274c-.8413-.63096-2.04202-.40944-2.60274.48024z" fill="#fff" fill-rule="evenodd"/></g></svg>
+<svg width="24" height="24" viewBox="0 0 24 24" fill="none" xmlns="http://www.w3.org/2000/svg">
+<g clip-path="url(#clip0_4_39)">
+<path d="M11.9991 0.0478516C5.26616 0.0478516 0.046875 4.9798 0.046875 11.6415C0.046875 15.1263 1.47492 18.1368 3.80034 20.2169C3.99588 20.3914 4.11349 20.6367 4.12162 20.8982L4.18664 23.0247C4.20719 23.7027 4.90807 24.1439 5.52815 23.87L7.90042 22.8225C8.1017 22.7341 8.32688 22.7173 8.53867 22.7761C9.62919 23.0759 10.789 23.2356 11.9986 23.2356C18.7315 23.2356 23.9508 18.3036 23.9508 11.642C23.9508 4.98028 18.732 0.0478516 11.9991 0.0478516ZM19.4056 8.54777L15.2443 14.979C15.033 15.3055 14.5975 15.3988 14.2709 15.1875L10.4161 12.6933C10.267 12.5967 10.0738 12.5996 9.92751 12.7004L5.58265 15.6971C4.94871 16.1341 4.17373 15.382 4.59205 14.7357L8.75381 8.30442C8.96512 7.97789 9.40066 7.88466 9.72672 8.09598L13.5825 10.5906C13.7317 10.6872 13.9248 10.6843 14.0711 10.5835L18.415 7.58729C19.0489 7.14984 19.8239 7.90235 19.4056 8.54873V8.54777Z" fill="white"/>
+</g>
+<defs>
+<clipPath id="clip0_4_39">
+<rect width="24" height="24" fill="white"/>
+</clipPath>
+</defs>
+</svg>
--- a/images/icons/signal-alt.svg
+++ b/images/icons/signal-alt.svg
@@ -0,0 +1,26 @@
+<svg width="24" height="24" viewBox="0 0 24 24" fill="none" xmlns="http://www.w3.org/2000/svg">
+<g clip-path="url(#clip0_25_65)">
+<path d="M12 0C12.6226 0 13.2341 0.0474105 13.8311 0.138818L13.6594 1.2508C13.1184 1.16797 12.5642 1.125 12 1.125C11.4358 1.125 10.8817 1.16796 10.3407 1.25079L10.169 0.138806C10.766 0.0474064 11.3775 0 12 0Z" fill="#3B45FD"/>
+<path d="M14.8477 0.339844L14.5808 1.43298C15.6772 1.69982 16.7085 2.13289 17.6466 2.70394L18.2308 1.74229C17.1957 1.11215 16.0576 0.634298 14.8477 0.339844Z" fill="#3B45FD"/>
+<path d="M19.0918 2.31885L18.427 3.22645C19.3236 3.88437 20.1156 4.67641 20.7735 5.57301L21.6811 4.90815C20.9551 3.91879 20.0812 3.04482 19.0918 2.31885Z" fill="#3B45FD"/>
+<path d="M22.2576 5.76953L21.296 6.35366C21.867 7.29178 22.3001 8.32315 22.5669 9.41959L23.6601 9.15262C23.3656 7.94276 22.8878 6.8047 22.2576 5.76953Z" fill="#3B45FD"/>
+<path d="M23.8612 10.1689L22.7491 10.3406C22.8321 10.8816 22.875 11.4358 22.875 11.9999C22.875 12.5641 22.8321 13.1183 22.7491 13.6594L23.8612 13.831C23.9526 13.234 24 12.6225 24 11.9999C24 11.3774 23.9526 10.7659 23.8612 10.1689Z" fill="#3B45FD"/>
+<path d="M21.296 17.6466C21.867 16.7083 22.3001 15.6771 22.5669 14.5806L23.6601 14.8475C23.3656 16.0575 22.8878 17.1955 22.2576 18.2307L21.296 17.6466Z" fill="#3B45FD"/>
+<path d="M20.7735 18.4272L21.6812 19.092C20.9552 20.0814 20.0813 20.9553 19.0919 21.6813L18.4269 20.7737C19.3236 20.1158 20.1156 19.3238 20.7735 18.4272Z" fill="#3B45FD"/>
+<path d="M17.6466 21.2959L18.2307 22.2575C17.1956 22.8877 16.0575 23.3656 14.8476 23.66L14.5807 22.5668C15.6771 22.3 16.7085 21.8669 17.6466 21.2959Z" fill="#3B45FD"/>
+<path d="M13.6593 22.749L13.831 23.8611C13.234 23.9525 12.6225 23.9999 12 23.9999C11.3774 23.9999 10.7659 23.9525 10.1689 23.8611L10.3405 22.7492C10.8813 22.832 11.4355 22.8749 12 22.8749C12.5642 22.8749 13.1183 22.832 13.6593 22.749Z" fill="#3B45FD"/>
+<path d="M9.41917 22.5672L9.15226 23.6601C8.24343 23.4388 7.37511 23.1142 6.56049 22.6992L5.42159 22.965L5.16596 21.8694L6.70501 21.5103L7.07113 21.6967C7.80894 22.0726 8.59548 22.3668 9.41917 22.5672Z" fill="#3B45FD"/>
+<path d="M4.21646 22.0909L4.47209 23.1865L2.51991 23.6419C1.22079 23.945 0.0548528 22.7791 0.357982 21.4801L0.813491 19.5278L1.90907 19.7834L1.45355 21.7357C1.33988 22.2229 1.77711 22.66 2.26428 22.5464L4.21646 22.0909Z" fill="#3B45FD"/>
+<path d="M2.13062 18.8338L1.03504 18.5782L1.30079 17.4393C0.885789 16.6246 0.561101 15.7563 0.339908 14.8475L1.43279 14.5806C1.63319 15.4042 1.92735 16.1908 2.30321 16.9287L2.48973 17.2948L2.13062 18.8338Z" fill="#3B45FD"/>
+<path d="M1.25064 13.6594L0.138804 13.831C0.0474057 13.234 0 12.6226 0 12C0 11.3775 0.04741 10.766 0.138817 10.1689L1.2508 10.3406C1.16797 10.8817 1.125 11.4358 1.125 12C1.125 12.5645 1.16792 13.1186 1.25064 13.6594Z" fill="#3B45FD"/>
+<path d="M1.43306 9.4191L0.339927 9.15213C0.63438 7.94227 1.11223 6.80421 1.74237 5.76904L2.70402 6.35317C2.13297 7.29129 1.69991 8.32266 1.43306 9.4191Z" fill="#3B45FD"/>
+<path d="M3.22647 5.57299L2.31886 4.90813C3.04483 3.91878 3.91881 3.04482 4.90817 2.31885L5.57303 3.22645C4.67643 3.88437 3.88438 4.6764 3.22647 5.57299Z" fill="#3B45FD"/>
+<path d="M6.3534 2.70392L5.76926 1.74226C6.80442 1.11214 7.94249 0.634292 9.15236 0.339844L9.41933 1.43298C8.32289 1.69982 7.29151 2.13286 6.3534 2.70392Z" fill="#3B45FD"/>
+<path d="M21.75 12C21.75 17.3849 17.3849 21.75 12 21.75C10.292 21.75 8.68661 21.3108 7.29053 20.5392C7.15611 20.4649 6.99927 20.4405 6.84969 20.4753L2.51268 21.4873L3.52466 17.1503C3.55955 17.0007 3.53503 16.8438 3.46075 16.7094C2.68917 15.3134 2.25 13.708 2.25 12C2.25 6.61523 6.61523 2.25 12 2.25C17.3849 2.25 21.75 6.61523 21.75 12Z" fill="#3B45FD"/>
+</g>
+<defs>
+<clipPath id="clip0_25_65">
+<rect width="24" height="24" fill="white"/>
+</clipPath>
+</defs>
+</svg>
--- a/index.html
+++ b/index.html
@@ -34,6 +34,11 @@
    <link rel="stylesheet" href="css/style.css">
    <link rel="stylesheet" href="css/brands.css">
  
+    <!-- LittleLink Extended Stylesheet (Optional) -->
+    <!-- <link rel="stylesheet" href="css/brands-extended.css"> -->
+    <!-- Learn more at https://github.com/sethcottle/littlelink-extended. 
+         Remove comments if you've added LittleLink Extended dependencies -->
+
  </head>

 <body>
@@ -206,6 +211,9 @@
              <!-- Mastodon -->
              <a class="button button-mastodon" href="#" target="_blank" rel="noopener" role="button"><img class="icon" aria-hidden="true" src="images/icons/mastodon.svg" alt="Mastodon Logo">Mastodon</a>

+              <!-- Matrix -->
+              <a class="button button-matrix" href="#" target="_blank" rel="noopener" role="button"><img class="icon" aria-hidden="true" src="images/icons/matrix.svg" alt="Matrix Logo">Matrix</a>
+
              <!-- Medium -->
              <a class="button button-medium" href="#" target="_blank" rel="noopener" role="button"><img class="icon" aria-hidden="true" src="images/icons/medium.svg" alt="Medium Logo">Medium</a>

@@ -242,6 +250,9 @@
              <!-- Signal -->
              <a class="button button-signal" href="#" target="_blank" rel="noopener" role="button"><img class="icon" aria-hidden="true" src="images/icons/signal.svg" alt="Signal Logo">Signal</a>

+              <!-- Signal Alt -->
+              <a class="button button-signal-alt" href="#" target="_blank" rel="noopener" role="button"><img class="icon" aria-hidden="true" src="images/icons/signal-alt.svg" alt="Signal Logo">Signal</a>
+
              <!-- Slack -->
              <a class="button button-slack" href="#" target="_blank" rel="noopener" role="button"><img class="icon" aria-hidden="true" src="images/icons/slack.svg" alt="Slack Logo">Join Slack</a>

@@ -377,6 +388,9 @@
              <!-- Generic Website -->
              <a class="button button-default" href="#" target="_blank" rel="noopener" role="button"><img class="icon" aria-hidden="true" src="images/icons/generic-website.svg" alt="Website Icon">Visit Website</a>

+              <!-- LittleLink Extended -->
+              <a class="button button-default" href="https://github.com/sethcottle/littlelink-extended" target="_blank" rel="noopener" role="button"><img class="icon" aria-hidden="true" src="images/icons/littlelink.svg" alt="LittleLink Logo">LittleLink Extended</a>
+
      </div>
        
      <!-- Feel free to add your own footer information, including updating `privacy.html` to reflect how your LittleLink fork is set up -->
Author	SHA1	Message	Date
Seth Cottle	573e1c21ad	Update VERSION.md	2025-03-25 20:42:44 -04:00
Seth Cottle	d6fd8a28b1	Updates Signal Brand Color + Adds Alt	2025-03-25 20:34:53 -04:00
Seth Cottle	23f2f1095f	Merge pull request #151 from lllahaye/feature/Docker-support Add Docker Support to the Project	2025-03-25 19:59:20 -04:00
Seth Cottle	915605c637	Update contrast-check.yml	2025-03-17 20:11:29 -04:00
Seth Cottle	a292324f01	Remove Script	2025-03-17 20:07:29 -04:00
Seth Cottle	2a384ae6ba	Update contrast-check.yml	2025-03-17 18:51:05 -04:00
Seth Cottle	3e580dbca6	Create contrast-check.yml	2025-03-17 18:43:22 -04:00
Seth Cottle	3e71e529e2	revert	2025-03-17 18:41:30 -04:00
Seth Cottle	7eff8dee81	manual trigger	2025-03-17 18:38:43 -04:00
Seth Cottle	61ff1bff39	Merge pull request #152 from sethcottle/actions Contrast Workflow	2025-03-17 18:33:51 -04:00
Seth Cottle	a13ec80c62	Contrast Workflow	2025-03-17 18:32:07 -04:00
Lian Leon	b29c8b23d5	Add Docker support	2025-03-17 13:18:40 -04:00
Lian Leon	8defce6119	Add Docker support section to README.md	2025-03-17 13:08:35 -04:00
Seth Cottle	24b374f557	LittleLink Extended	2025-03-10 12:10:27 -04:00
Seth Cottle	df23da72c2	Update VERSION.md	2025-03-07 15:19:50 -05:00
Seth Cottle	13bdbe44ae	Update VERSION.md	2025-03-07 15:19:39 -05:00
Seth Cottle	0e2edc3135	Merge pull request #146 from ji3o/main	2025-03-04 19:07:37 -05:00
Julian Graßhoff	98b9cba737	Added missing boarder to Matrix button	2025-03-04 16:45:16 +01:00
Julian Graßhoff	54afafdf2b	Added a button for Matrix network.	2025-03-04 14:53:52 +01:00
Seth Cottle	b223dbddd3	Brand Updates - Updated Facebook Logo - Updated Messenger Logo - Updated Messenger Button Color	2025-03-01 15:47:07 -05:00
Seth Cottle	4db16003e2	Update README.md	2025-02-19 15:13:10 -05:00
Seth Cottle	716d98a748	Delete directory	2025-02-16 01:59:45 -05:00