Screenly · nicomiguelino · Jan 27, 2026 · Jan 27, 2026 · Jan 27, 2026 · Jan 27, 2026
diff --git a/edge-apps/birthday-greeting/README.md b/edge-apps/birthday-greeting/README.md
@@ -0,0 +1,67 @@
+# Birthday Greeting
+
+A vibrant and responsive birthday greeting app for digital signage displays. This app displays personalized birthday messages with the person's name, role, and optional photo.
+
+## Features
+
+- Personalized birthday greeting with name and role
+- Optional photo support with Base64 image encoding
+- Fallback placeholder when no photo is provided
+
+## Deployment
+
+Create and deploy the Edge App:
+
+```bash
+bun install
+screenly edge-app create --name birthday-greeting --in-place
+bun run deploy
+```
+
+## Configuration
+
+The app accepts the following settings via `screenly.yml`:
+
+- `name` (required) - The name of the person having a birthday (e.g., "Amy Smith")
+- `role` (required) - The role or position of the person (e.g., "Sales Manager")
+- `image` (optional) - A Base64-encoded image of the person. If not provided or if the image fails to load, a placeholder will be displayed
+
+### Example Configuration
+
+```yaml
+name: 'Amy Smith'
+role: 'Sales Manager'
+image: 'data:image/jpeg;base64,/9j/4AAQSkZJRg...'
+```
+
+## Image Format
+
+The `image` setting accepts Base64-encoded images in the following formats:
+
+1. **Full data URI** (recommended):
+
+   ```text
+   data:image/jpeg;base64,/9j/4AAQSkZJRg...
+   ```
+
+2. **Pure Base64 string** (will be automatically formatted):
+   ```text
+   /9j/4AAQSkZJRg...
+   ```
+
+## Development
+
+```bash
+bun install      # Install dependencies
+bun run build    # Build the app
+bun run dev      # Start development server
+bun run lint     # Lint and fix code
+```
+
+## Testing
+
+The app includes comprehensive tests for settings retrieval and image handling.
+
+```bash
+bun run test     # Run all tests
+```
diff --git a/edge-apps/birthday-greeting/bun.lock b/edge-apps/birthday-greeting/bun.lock
diff --git a/edge-apps/birthday-greeting/index.html b/edge-apps/birthday-greeting/index.html
@@ -0,0 +1,41 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>Birthday Greeting - Screenly Edge App</title>
+    <script src="screenly.js?version=1"></script>
+    <link rel="stylesheet" href="dist/css/style.css" />
+  </head>
+  <body>
+    <div class="container max-w-full">
+      <main class="main-content">
+        <div class="left-column h-full">
+          <div id="screenly-logo"></div>
+          <h1 class="greeting-title">
+            Happy<br />Birthday,<br /><span id="person-name"></span>!
+          </h1>
+          <p class="greeting-message">Wishing you all the best!</p>
+        </div>
+
+        <div class="right-column h-full">
+          <div class="photo-frame">
+            <div class="photo-container">
+              <div id="photo-placeholder" class="photo-placeholder"></div>
+              <img
+                id="person-photo"
+                class="person-photo hidden"
+                alt="Birthday photo"
+              />
+            </div>
+          </div>
+          <div class="role-badge">
+            <p class="role-label">Our very own</p>
+            <p id="person-role" class="role-title"></p>
+          </div>
+        </div>
+      </main>
+    </div>
+    <script src="dist/js/main.js"></script>
+  </body>
+</html>
diff --git a/edge-apps/birthday-greeting/package.json b/edge-apps/birthday-greeting/package.json
@@ -0,0 +1,35 @@
+{
+  "name": "birthday-greeting",
+  "version": "1.0.0",
+  "type": "module",
+  "scripts": {
+    "prebuild": "bun run type-check",
+    "generate-mock-data": "screenly edge-app run --generate-mock-data",
+    "predev": "bun run generate-mock-data && edge-apps-scripts build",
+    "dev": "run-p build:dev edge-app-server",
+    "edge-app-server": "screenly edge-app run",
+    "build": "edge-apps-scripts build",
+    "build:dev": "edge-apps-scripts build:dev",
+    "build:prod": "edge-apps-scripts build",
+    "test": "bun test",
+    "test:unit": "bun test",
+    "lint": "edge-apps-scripts lint --fix",
+    "format": "prettier --write src/ README.md index.html",
+    "format:check": "prettier --check src/ README.md index.html",
+    "deploy": "bun run build && screenly edge-app deploy",
+    "type-check": "edge-apps-scripts type-check",
+    "prepare": "cd ../edge-apps-library && bun install && bun run build"
+  },
+  "dependencies": {},
+  "prettier": "../edge-apps-library/.prettierrc.json",
+  "devDependencies": {
+    "@screenly/edge-apps": "workspace:../edge-apps-library",
+    "@types/bun": "^1.3.6",
+    "@types/jsdom": "^27.0.0",
+    "bun-types": "^1.3.6",
+    "jsdom": "^27.4.0",
+    "npm-run-all2": "^8.0.4",
+    "prettier": "^3.8.1",
+    "typescript": "^5.9.3"
+  }
+}
diff --git a/edge-apps/birthday-greeting/screenly.yml b/edge-apps/birthday-greeting/screenly.yml
@@ -0,0 +1,39 @@
+---
+syntax: manifest_v1
+description: A birthday greeting app that displays a personalized message with the person's name, role, and photo.
+icon: https://playground.srly.io/edge-apps/birthday-greeting/static/img/icon.svg
+author: Screenly, Inc.
+ready_signal: true
+settings:
+  display_errors:
+    type: string
+    default_value: 'false'
+    title: Display Errors
+    optional: true
+    help_text:
+      properties:
+        advanced: true
+        help_text: For debugging purposes to display errors on the screen.
+        type: boolean
+      schema_version: 1
+  image:
+    type: string
+    default_value: ''
+    title: Image
+    optional: false
+    help_text: |
+      A base64-encoded image of the person.
+  name:
+    type: string
+    default_value: ''
+    title: Name
+    optional: false
+    help_text: |
+      The name of the person having a birthday (e.g., "Amy Smith").
+  role:
+    type: string
+    default_value: ''
+    title: Role
+    optional: false
+    help_text: |
+      The role or position of the person (e.g., "Sales Manager").
diff --git a/edge-apps/birthday-greeting/screenly_qc.yml b/edge-apps/birthday-greeting/screenly_qc.yml
@@ -0,0 +1,39 @@
+---
+syntax: manifest_v1
+description: A birthday greeting app that displays a personalized message with the person's name, role, and photo.
+icon: https://playground.srly.io/edge-apps/birthday-greeting/static/img/icon.svg
+author: Screenly, Inc.
+ready_signal: true
+settings:
+  display_errors:
+    type: string
+    default_value: 'false'
+    title: Display Errors
+    optional: true
+    help_text:
+      properties:
+        advanced: true
+        help_text: For debugging purposes to display errors on the screen.
+        type: boolean
+      schema_version: 1
+  image:
+    type: string
+    default_value: ''
+    title: Image
+    optional: false
+    help_text: |
+      A base64-encoded image of the person.
+  name:
+    type: string
+    default_value: ''
+    title: Name
+    optional: false
+    help_text: |
+      The name of the person having a birthday (e.g., "Amy Smith").
+  role:
+    type: string
+    default_value: ''
+    title: Role
+    optional: false
+    help_text: |
+      The role or position of the person (e.g., "Sales Manager").