From fcf2b7ef2add610590cae4a0c57c35da7ceebf07 Mon Sep 17 00:00:00 2001
From: Michael Genson <genson.michael@gmail.com>
Date: Sat, 28 Mar 2026 01:05:08 +0000
Subject: [PATCH] implement basic placeholder announcement

---
 .../Announcement/AnnouncementDialog.vue       | 67 ++++++++++++++++++-
 .../Announcements/2026-03-27_1_welcome.vue    | 13 ++++
 .../Layout/LayoutParts/AppSidebar.vue         |  2 +-
 frontend/composables/use-announcements.ts     | 37 +++++++++-
 4 files changed, 114 insertions(+), 5 deletions(-)
 create mode 100644 frontend/components/Domain/Announcement/Announcements/2026-03-27_1_welcome.vue

diff --git a/frontend/components/Domain/Announcement/AnnouncementDialog.vue b/frontend/components/Domain/Announcement/AnnouncementDialog.vue
index b117a82a8..ff4f93e42 100644
--- a/frontend/components/Domain/Announcement/AnnouncementDialog.vue
+++ b/frontend/components/Domain/Announcement/AnnouncementDialog.vue
@@ -1,11 +1,76 @@
 <template>
   <BaseDialog
     v-model="dialog"
+    :title="$t('announcements.announcements')"
+    :icon="$globals.icons.bullhornVariant"
+    width="100%"
+    max-width="1200"
   >
-    test <!-- TODO -->
+    <v-card-title>
+      <v-chip label large class="me-1">
+        <v-icon class="me-1">
+          {{ $globals.icons.calendar }}
+        </v-icon>
+        {{ $d(new Date(currentAnnouncement.key.split('_', 1)[0])) }}
+      </v-chip>
+      {{ currentAnnouncement.meta?.title }}
+    </v-card-title>
+    <v-card-text>
+      <component :is="currentAnnouncement.component" />
+    </v-card-text>
   </BaseDialog>
 </template>
 
 <script setup lang="ts">
+import { useAnnouncements } from "~/composables/use-announcements";
+import { useUserApi } from "~/composables/api";
+
 const dialog = defineModel<boolean>({ default: false });
+
+const auth = useMealieAuth();
+const api = useUserApi();
+const { newAnnouncements, allAnnouncements } = useAnnouncements();
+
+const currentAnnouncement = shallowRef(newAnnouncements.value.at(0) || allAnnouncements.at(-1)!);
+watch(
+  () => dialog,
+  () => {
+    // Once the dialog is opened, mark the current announcement as read
+    if (dialog.value) {
+      setLastRead(currentAnnouncement.value.key);
+    }
+  },
+);
+
+async function setLastRead(key: string) {
+  const user = auth.user.value!;
+  if (user.lastReadAnnouncement && key < user.lastReadAnnouncement) {
+    // Don't update the last read announcement if it's older than the current one
+    return;
+  }
+
+  await api.users.updateOne(
+    user.id,
+    {
+      ...user,
+      lastReadAnnouncement: key,
+    },
+  );
+}
+
+function markAllAsRead() {
+  const newestAnnouncement = allAnnouncements.at(-1)!;
+  setLastRead(newestAnnouncement.key);
+}
+
+function nextAnnouncement() {
+  newAnnouncements.value.shift();
+  const nextAnnouncement = newAnnouncements.value.at(0);
+  if (!nextAnnouncement) {
+    return;
+  }
+
+  currentAnnouncement.value = nextAnnouncement;
+  setLastRead(currentAnnouncement.value.key);
+}
 </script>
diff --git a/frontend/components/Domain/Announcement/Announcements/2026-03-27_1_welcome.vue b/frontend/components/Domain/Announcement/Announcements/2026-03-27_1_welcome.vue
new file mode 100644
index 000000000..986c23067
--- /dev/null
+++ b/frontend/components/Domain/Announcement/Announcements/2026-03-27_1_welcome.vue
@@ -0,0 +1,13 @@
+<template>
+  <div>
+    Welcome to Mealie! This is a placeholder test announcement.
+  </div>
+</template>
+
+<script lang="ts">
+import type { AnnouncementMeta } from "~/composables/use-announcements";
+
+export const meta: AnnouncementMeta = {
+  title: "Placeholder Title",
+};
+</script>
diff --git a/frontend/components/Layout/LayoutParts/AppSidebar.vue b/frontend/components/Layout/LayoutParts/AppSidebar.vue
index 71abeabeb..a470ac2fe 100644
--- a/frontend/components/Layout/LayoutParts/AppSidebar.vue
+++ b/frontend/components/Layout/LayoutParts/AppSidebar.vue
@@ -125,7 +125,7 @@
         >
           <template #prepend>
             <v-badge
-              :model-value="!!newAnnouncements?.length"
+              :model-value="!!newAnnouncements.length"
               color="accent"
               :content="newAnnouncements?.length"
               offset-x="-2"
diff --git a/frontend/composables/use-announcements.ts b/frontend/composables/use-announcements.ts
index 74a7f2463..ca6d44ec8 100644
--- a/frontend/composables/use-announcements.ts
+++ b/frontend/composables/use-announcements.ts
@@ -1,6 +1,28 @@
 import { useHouseholdSelf } from "~/composables/use-households";
 import { useGroupSelf } from "~/composables/use-groups";
 
+export type AnnouncementMeta = {
+  title: string | undefined;
+};
+
+export type Announcement = {
+  key: string;
+  component: Component;
+  meta: AnnouncementMeta | undefined;
+};
+
+const _announcementsUnsorted = import.meta.glob<{ default: Component; meta?: AnnouncementMeta }>(
+  "~/components/Domain/Announcement/Announcements/*.vue",
+  { eager: true },
+);
+const allAnnouncements: Announcement[] = Object.entries(_announcementsUnsorted)
+  .sort(([a], [b]) => a.localeCompare(b))
+  .map(([path, mod]) => ({
+    key: path.split("/").at(-1)!.replace(".vue", ""),
+    component: mod.default,
+    meta: mod.meta,
+  }));
+
 export function useAnnouncements() {
   const auth = useMealieAuth();
   const { household } = useHouseholdSelf();
@@ -15,10 +37,18 @@ export function useAnnouncements() {
       ),
   );
 
-  const newAnnouncements = ref<string[] | undefined>();
+  const newAnnouncements = shallowRef<Announcement[]>([]);
   function refreshUnreadAnnouncements() {
-    if (!auth.user.value) {
-      newAnnouncements.value = undefined;
+    // Only logged-in users can see announcements
+    if (!auth.user.value || !allAnnouncements.length) {
+      newAnnouncements.value = [];
+      return;
+    }
+
+    // If a user has never seen an announcement, show them only the welcome announcement
+    if (!auth.user.value.lastReadAnnouncement) {
+      newAnnouncements.value = [allAnnouncements.at(0)!];
+      return;
     }
 
     newAnnouncements.value = []; // TODO
@@ -32,5 +62,6 @@ export function useAnnouncements() {
   return {
     announcementsEnabled,
     newAnnouncements,
+    allAnnouncements,
   };
 }