Bump version to 2.4 and add CSS editor changelog entry

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>

.env.example

@@ -0,0 +1,5 @@
+# Environment Variables for Sucker
+
+# Disable Discord community banner (optional)
+# Uncomment the line below to hide the Discord banner
+# NEXT_PUBLIC_DISABLE_DISCORD_BANNER=true

.github/copilot-instructions.md

@@ -0,0 +1,47 @@
+# Copilot Instructions for sucker.severian.dev
+
+## Project Overview
+- This is a Next.js project with a custom proxy API and UI components, using Tailwind CSS and PostCSS for styling.
+- The main app logic is in `src/app/`, with global styles in `globals.css` and layout in `layout.tsx`.
+- API routes are under `src/app/api/proxy/`, including image proxying (`image/route.ts`).
+- UI components are in `src/components/ui/` and utility functions in `src/components/lib/`.
+
+## Architecture & Data Flow
+- The app uses Next.js routing and API routes for backend logic. The proxy API handles requests to external services, including image fetching and transformation.
+- UI components follow a modular pattern, with reusable elements (e.g., `button.tsx`, `card.tsx`).
+- Data flows from API routes to UI via React props and hooks. No global state management library is present.
+
+## Developer Workflows
+- **Build & Dev:** Use `npm run dev` to start the development server. Check `package.json` for other scripts.
+- **Styling:** Tailwind CSS is configured via `tailwind.config.js` and PostCSS via `postcss.config.js`.
+- **API:** Custom logic for proxying and image handling is in `src/app/api/proxy/`. Review these files for request/response patterns.
+- **No test suite detected.** If adding tests, follow Next.js and React conventions.
+
+## Project-Specific Conventions
+- API routes use Next.js `route.ts` files, with custom logic for proxying and image manipulation.
+- UI components are colocated in `src/components/ui/` and use Tailwind utility classes.
+- Utility functions (e.g., PNG handling) are in `src/components/lib/`.
+- Minimal documentation; refer to code for implementation details.
+- Changelog is maintained in `README.md`.
+
+## Integration Points & External Dependencies
+- Relies on Next.js, React, Tailwind CSS, and PostCSS.
+- External requests are proxied via custom API routes.
+- Docker support via `docker-compose.yml` and `dockerfile` for containerization.
+
+## Examples
+- To add a new API route: create a `route.ts` under `src/app/api/yourroute/`.
+- To add a new UI component: place a `.tsx` file in `src/components/ui/` and use Tailwind for styling.
+- For image processing, review `src/app/api/proxy/image/route.ts` and `src/components/lib/png.ts`.
+
+## Key Files & Directories
+- `src/app/` — Main app logic and API routes
+- `src/components/ui/` — UI components
+- `src/components/lib/` — Utility functions
+- `tailwind.config.js`, `postcss.config.js` — Styling configuration
+- `docker-compose.yml`, `dockerfile` — Containerization
+- `README.md` — Changelog and minimal project notes
+
+---
+
+If any section is unclear or missing important project-specific details, please provide feedback to improve these instructions.

.gitignore

@@ -1,2 +1,4 @@
 node_modules
-.next
+.next
+.env.local
+.env*.local

README.md

@@ -1,9 +1,26 @@
 # Sucker
 
-Check package.json for commands, I can't be bothered.
+### Environment Variables
+
+Add these to your `.env.local` file (optional):
+
+```bash
+# Disable Discord community banner (defaults to showing banner)
+NEXT_PUBLIC_DISABLE_DISCORD_BANNER=true
+```
+
+### Usage
+
+Pull this repostory and build with `npm run build`. You can start the server with `node ./.next/standalone/server.js`
+
+You can also build and run Sucker as a Docker container with `docker compose build` and `docker compose up`.
 
 ### Changelog
 
+- 2.4: CSS editor for Janitor profiles. New banner links to the live-preview editor at tools.from-avalon.com/janitor-profile-maker.
+- 2.3: ECHO. Put ECHO: anywhere in a message and sucker repeats whatever comes after it in the reply — for triggering char-side script and lorebook keywords.
+- 2.2: Added support for directly inputting webp file names or character image links when creating PNG character cards
+- 2.1: updated deps, note about image fetching, list of mirrors
 - 2.0: from Tui: Multimessage support! Tracks changes to character descriptions and scenarios across multiple extractions. Shows version badges, message counts, and provides detailed change history viewer.
 - also 2.0: V2 charcard format and alternate greetings.
 - 1.9: Not again. They changed stuff again. What is this?

docker-compose.yml

@@ -2,7 +2,6 @@ services:
   web:
     build: .
     image: sucker
+    restart: unless-stopped
     ports:
-      - "3000:3000"
+      - "3000:3000"
-    environment:
-      NODE_ENV: production

dockerfile

@@ -1,7 +1,5 @@
-FROM node:18-alpine AS base
+FROM node:22-alpine AS base
-
 WORKDIR /app
-
 FROM base AS deps
 COPY package.json package-lock.json* yarn.lock* pnpm-lock.yaml* ./
 RUN \
@@ -12,23 +10,22 @@ RUN \
   fi
 
 FROM base AS builder
+WORKDIR /app
+
+ENV NODE_ENV=production
+
 COPY --from=deps /app/node_modules ./node_modules
 COPY . .
 RUN npm run build
 
-FROM base AS runner
+FROM node:22-alpine AS runner
-ENV NODE_ENV=production
-
-RUN addgroup --system --gid 1001 nodejs && adduser --system --uid 1001 nextjs
-
 WORKDIR /app
-
+RUN addgroup --system --gid 1001 nodejs && adduser --system --uid 1001 nextjs
+COPY --from=builder /app/.next/standalone ./
+COPY --from=builder /app/.next/static ./.next/static
 COPY --from=builder /app/public ./public
-COPY --from=builder /app/.next ./.next
-COPY --from=builder /app/node_modules ./node_modules
-COPY --from=builder /app/package.json ./package.json
 
 USER nextjs
 
 EXPOSE 3000
-CMD ["npm", "start"]
+CMD ["node", "server.js"]

next-env.d.ts

@@ -1,5 +1,6 @@
 /// <reference types="next" />
 /// <reference types="next/image-types/global" />
+import "./.next/dev/types/routes.d.ts";
 
 // NOTE: This file should not be edited
-// see https://nextjs.org/docs/app/building-your-application/configuring/typescript for more information.
+// see https://nextjs.org/docs/app/api-reference/config/typescript for more information.

next.config.js

@@ -0,0 +1,7 @@
+/** @type {import('next').NextConfig} */
+const nextConfig = {
+  output: 'standalone',
+  productionBrowserSourceMaps: false,
+};
+
+module.exports = nextConfig;

package.json

@@ -12,10 +12,11 @@
     "@radix-ui/react-accordion": "^1.2.2",
     "@radix-ui/react-collapsible": "^1.1.2",
     "@radix-ui/react-dialog": "^1.1.4",
+    "@radix-ui/react-dropdown-menu": "^2.1.16",
     "@radix-ui/react-separator": "^1.1.1",
     "@radix-ui/react-slot": "^1.1.1",
-    "@types/react": "^18.2.39",
+    "@types/react": "^19.2.7",
-    "@types/react-dom": "^18.2.17",
+    "@types/react-dom": "^19.2.3",
     "axios": "^1.6.2",
     "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",
@@ -23,9 +24,9 @@
     "crc-32": "^1.2.2",
     "html2canvas": "^1.4.1",
     "lucide-react": "^0.471.0",
-    "next": "^14.0.3",
+    "next": "^16.0.7",
-    "react": "^18.2.0",
+    "react": "^19.2.1",
-    "react-dom": "^18.2.0",
+    "react-dom": "^19.2.1",
     "tailwind-merge": "^2.6.0",
     "tailwindcss-animate": "^1.0.7",
     "typescript": "^5.3.2"

src/app/api/proxy/route.ts

@@ -93,6 +93,15 @@ function parseConversationToken(content: string | undefined | null): string | nu
   return null;
 }
 
+function parseEchoText(content: string | undefined | null): string | null {
+  if (!content) return null;
+  const match = content.match(/ECHO:\s*([\s\S]+)/i);
+  if (match && match[1].trim()) {
+    return match[1].trim();
+  }
+  return null;
+}
+
 function removePersonaTags(content: string): string {
   let result = content;
   const openingMatch = result.match(/<[^<>]+?\s*'s\s+Persona>/i);
@@ -487,6 +496,18 @@ export async function POST(request: NextRequest) {
       responseMessage = `New character "${extracted.data.name}" created (v1).${tokenNote}`;
     }
 
+    // Echo back anything the user sent after an "ECHO:" marker in their
+    // latest message, appended after the normal status message
+    const lastUserMessage =
+      [...body.messages]
+        .reverse()
+        .find((m: { role?: string }) => m?.role === "user") ??
+      body.messages[body.messages.length - 1];
+    const echoText = parseEchoText(lastUserMessage?.content);
+    if (echoText) {
+      responseMessage += `\n\n${echoText}`;
+    }
+
     cleanupExpiredCards();
 
     // Return SSE response if requested, otherwise JSON
@@ -528,7 +549,7 @@ export async function POST(request: NextRequest) {
     console.error("Error processing request:", error);
 
     const errorMessage =
-      "You dingus, read the directions on sucker before trying again.";
+      "You dingus, read the directions on sucker before trying again. If you're trying to suck a bot with more tokens than your current context limit, try bumping your Context Size setting up on Generation Settings.";
 
     // Check if this was a streaming request
     const acceptHeader = request.headers.get("accept");

src/app/page.tsx

@@ -20,17 +20,20 @@ import {
 import { Input } from "@/components/ui/input";
 import { Png } from "@/lib/png";
 import {
-  ChevronUp,
-  ChevronDown,
   Copy,
   ChevronLeft,
   ChevronRight,
+  Menu,
 } from "lucide-react";
 import {
-  CollapsibleContent,
+  DropdownMenu,
-  Collapsible,
+  DropdownMenuTrigger,
-  CollapsibleTrigger,
+  DropdownMenuContent,
-} from "@/components/ui/collapsible";
+  DropdownMenuItem,
+} from "@/components/ui/dropdown-menu";
+import { DiscordBannerPermanent } from "@/components/ui/discord-banner-permanent";
+import { CssEditorBanner } from "@/components/ui/css-editor-banner";
+import { BannerCarousel } from "@/components/ui/banner-carousel";
 import Script from "next/script";
 
 interface CardDataV2 {
@@ -65,7 +68,6 @@ interface Card {
 }
 
 export default function Home() {
-  const [isInstructionsOpen, setIsInstructionsOpen] = useState(false);
   const [cards, setCards] = useState<Card[]>([]);
   const [dialogOpen, setDialogOpen] = useState(false);
   const [selectedCardIndex, setSelectedCardIndex] = useState<number | null>(
@@ -81,8 +83,13 @@ export default function Home() {
   const [altGreetingIndexById, setAltGreetingIndexById] = useState<
     Record<string, number>
   >({});
+  const [mirrorsDialogOpen, setMirrorsDialogOpen] = useState(false);
+  const [changelogDialogOpen, setChangelogDialogOpen] = useState(false);
+  const [howToUseDialogOpen, setHowToUseDialogOpen] = useState(false);
 
-  const [proxyUrl, setProxyUrl] = useState("https://sucker.severian.dev/api/proxy");
+  const [proxyUrl, setProxyUrl] = useState(
+    "https://sucker.severian.dev/api/proxy"
+  );
 
   const fetchCards = async () => {
     try {
@@ -255,12 +262,11 @@ export default function Home() {
       const cardData = JSON.stringify(pngData);
 
       const newImageData = Png.Generate(arrayBuffer, cardData);
-      const newFileName = `${
+      const newFileName = `${(card.initialVersion?.name || card.data.name).replace(
-        (card.initialVersion?.name || card.data.name).replace(
+        /[^a-zA-Z0-9\-_]/g,
-          /[^a-zA-Z0-9\-_]/g,
+        "_"
-          "_"
+      ) || "character"
-        ) || "character"
+        }.png`;
-      }.png`;
       const newFile = new File([new Uint8Array(newImageData)], newFileName, {
         type: "image/png",
       });
@@ -287,14 +293,44 @@ export default function Home() {
   };
 
   const handleOpenMetadata = () => {
-    const match = characterUrl.match(/characters\/([\w-]+)/);
+    // Check if the input is a character metadata URL (janitorai.com/characters/...)
-    if (match && match[1]) {
+    const isCharacterUrl = /janitorai\.com\/characters\//.test(characterUrl);
-      const characterId = match[1].split("_")[0];
+
-      window.open(
+    if (isCharacterUrl) {
-        `https://janitorai.com/hampter/characters/${characterId}`,
+      // Extract character ID and open metadata page, then show second input
-        "_blank"
+      const match = characterUrl.match(/characters\/([\w-]+)/);
-      );
+      if (match && match[1]) {
-      setIsMetadataOpen(true);
+        const characterId = match[1].split("_")[0];
+        window.open(
+          `https://janitorai.com/hampter/characters/${characterId}`,
+          "_blank"
+        );
+        setIsMetadataOpen(true);
+      }
+      return;
+    }
+
+    // Check if the input is a direct image link (webp filename or full image URL)
+    const isImagePath = /\.(webp|png|jpg|jpeg|gif)(\?.*)?$/i.test(characterUrl);
+    const isFullImageUrl = (characterUrl.startsWith("http://") || characterUrl.startsWith("https://")) && isImagePath;
+    const isWebpFilename = /^[\w-]+\.(webp|png|jpg|jpeg|gif)$/i.test(characterUrl);
+
+    if (isFullImageUrl || isWebpFilename) {
+      // Directly set the avatar URL without opening metadata
+      if (selectedCardIndex === null) return;
+
+      const avatarUrl = isFullImageUrl
+        ? characterUrl
+        : `https://ella.janitorai.com/bot-avatars/${characterUrl}`;
+
+      const updatedCards = [...cards];
+      updatedCards[selectedCardIndex] = {
+        ...updatedCards[selectedCardIndex],
+        avatarUrl,
+      };
+      setCards(updatedCards);
+      setDialogOpen(false);
+      return;
     }
   };
 
@@ -321,7 +357,10 @@ export default function Home() {
 
   return (
     <main className="min-h-screen bg-background text-foreground">
-      <Script src="https://www.googletagmanager.com/gtag/js?id=G-YVD6QFSR71" strategy="afterInteractive" />
+      <Script
+        src="https://www.googletagmanager.com/gtag/js?id=G-YVD6QFSR71"
+        strategy="afterInteractive"
+      />
       <Script id="gtag-init" strategy="afterInteractive">
         {`window.dataLayer = window.dataLayer || [];
         function gtag(){dataLayer.push(arguments);} 
@@ -329,122 +368,117 @@ export default function Home() {
         gtag('config', 'G-YVD6QFSR71');`}
       </Script>
       <div className="container mx-auto px-4 py-8">
-        <div className="flex justify-between items-center mb-4">
+        {/* Mobile Layout */}
-          <div>
+        <div className="sm:hidden mb-4">
-            <h1 className="text-3xl font-bold">Sucker v2.0</h1>
+          {/* Row 1: Title on left, Hamburger on right */}
-            <p className="text-sm text-muted-foreground">
+          <div className="flex justify-between items-start mb-3">
-              A couple of updates, see below.
+            <div>
-            </p>
+              <h1 className="text-2xl font-bold">Sucker v2.4</h1>
+              <p className="text-xs text-muted-foreground">
+                ECHO: Consider joining Avalon!
+              </p>
+            </div>
+            <DropdownMenu>
+              <DropdownMenuTrigger asChild>
+                <Button variant="outline" size="icon">
+                  <Menu className="h-4 w-4" />
+                </Button>
+              </DropdownMenuTrigger>
+              <DropdownMenuContent align="end">
+                <DropdownMenuItem onClick={() => setHowToUseDialogOpen(true)}>
+                  How to Use
+                </DropdownMenuItem>
+                <DropdownMenuItem onClick={() => setMirrorsDialogOpen(true)}>
+                  Mirrors
+                </DropdownMenuItem>
+                <DropdownMenuItem onClick={() => setChangelogDialogOpen(true)}>
+                  Changelog
+                </DropdownMenuItem>
+              </DropdownMenuContent>
+            </DropdownMenu>
           </div>
+          {/* Row 2: Full-width Refresh button */}
           <Button
             onClick={fetchCards}
             variant="outline"
             disabled={isRefreshing}
+            className="w-full"
           >
             {isRefreshing ? "Refreshing..." : "Refresh"}
           </Button>
         </div>
 
-        <Separator className="my-4" />
+        {/* Desktop Layout */}
-        <div className="mb-8">
+        <div className="hidden sm:flex justify-between items-center mb-4">
-          <div className="bg-blue-50 dark:bg-blue-950 border border-blue-200 dark:border-blue-800 rounded-lg p-4">
+          <div>
-            <div className="flex flex-col justify-between">
+            <h1 className="text-3xl font-bold">Sucker v2.4</h1>
-              <span className="text-lg font-semibold text-blue-800 dark:text-blue-200">
+            <p className="text-sm text-muted-foreground">
-                V2 charcard format, multi-turn support for scripts/lorebooks,
+              ECHO: Consider joining Avalon!
-                alternate greetings.
+            </p>
-              </span>
+          </div>
-              <p className="text-sm text-muted-foreground">
+          <div className="flex gap-2">
-                Sucker now tracks changes to character descriptions and
+            <Button
-                scenarios across multiple messages. Cards with multiple versions
+              onClick={() => setHowToUseDialogOpen(true)}
-                show a version badge and offer a "Download Changes" button to
+              variant="outline"
-                get the change history.
+            >
-                <br />
+              How to Use
-                Alternate greetings are also supported. Sucker will provide you
+            </Button>
-                with a conversation ID that you can use to start off a new chat
+            <Button
-                when capturing alternate greetings, send it as first message
+              onClick={() => setMirrorsDialogOpen(true)}
-                instead of the character name.
+              variant="outline"
-                <br />
+            >
-                Directions are updated below. Make sure you read 'em.
+              Mirrors
-                <br />
+            </Button>
-                If you're interested in hosting your own sucker instance, lmk
+            <Button
-                via Discord: @lyseverian, I've made the GH repo private for now.
+              onClick={() => setChangelogDialogOpen(true)}
-              </p>
+              variant="outline"
-            </div>
+            >
+              Changelog
+            </Button>
+            <Button
+              onClick={fetchCards}
+              variant="outline"
+              disabled={isRefreshing}
+            >
+              {isRefreshing ? "Refreshing..." : "Refresh"}
+            </Button>
           </div>
         </div>
 
-        <Collapsible
+        <Separator className="my-4" />
-          open={isInstructionsOpen}
+
-          onOpenChange={setIsInstructionsOpen}
+        {/* Discord Banner - Disabled if NEXT_PUBLIC_DISABLE_DISCORD_BANNER is set */}
-          className="w-full mb-8"
+        {process.env.NEXT_PUBLIC_DISABLE_DISCORD_BANNER !== "true" && (
-        >
+          <>
-          <div className="flex items-center justify-between">
+            {/* Desktop: banners side by side */}
-            <h2 className="text-2xl font-semibold">How to Use</h2>
+            <div className="hidden md:flex gap-4 mb-4 items-stretch">
-            <CollapsibleTrigger asChild>
+              <DiscordBannerPermanent
-              <Button variant="ghost" size="sm" className="w-9 p-0">
+                inviteLink="https://discord.gg/5jQKkCfHP3"
-                {isInstructionsOpen ? (
+                serverName="Avalon"
-                  <ChevronUp className="h-4 w-4" />
+                description="Avalon is an enchanted creative haven for a growing collective of botmakers and users—part workshop, part myth, part digital forest where strange and beautiful ideas come to life. Enter our little woodland here:"
-                ) : (
+                ctaText="Join Server"
-                  <ChevronDown className="h-4 w-4" />
+                className="flex-1 min-w-0"
-                )}
+              />
-                <span className="sr-only">Toggle instructions</span>
+              <CssEditorBanner className="flex-shrink-0 aspect-[16/10] w-[300px] lg:w-[360px] xl:w-[400px]" />
-              </Button>
-            </CollapsibleTrigger>
-          </div>
-          <CollapsibleContent className="mt-4">
-            <div className="prose dark:prose-invert max-w-none">
-              <p className="mb-2">
-                Follow every instruction here to the letter because it's all you
-                need to know and I have no intent of helping you further.
-              </p>
-              <ol className="list-decimal list-inside">
-                <li className="mb-2">
-                  Put <code style={{ color: "#fff0b9" }}>{proxyUrl}</code> in your
-                  API settings, any value for model and key.
-                </li>
-                <li className="mb-2">
-                  REQUIRED: Set your custom prompt to <code style={{ color: "#fff0b9" }}>&lt;.&gt;</code>
-                </li>
-                <li className="mb-2">
-                  REQUIRED: Set your persona (or create a new one) with the name{" "}
-                  <code style={{ color: "#fff0b9" }}>&#123;user&#125;</code> and the description should only
-                  have <code style={{ color: "#fff0b9" }}>.</code> in it.
-                </li>
-                <li className="mb-2">
-                  Save settings and refresh the page. Not this page. <i>That</i>{" "}
-                  page.
-                </li>
-                <li className="mb-2">Start a new chat with a character.</li>
-                <li className="mb-2">
-                  Char name inference is implemented: if you send just a dot: <code style={{ color: "#fff0b9" }}>.</code>, sucker will use the inferred name from the persona tag, or you can send the character name yourself.
-                </li>
-                <li className="mb-2">
-                  Hit the Refresh button here, and the cards should appear here.
-                </li>
-                <li className="mb-2">
-                  If you're interested in capturing alternate greetings, start a
-                  new chat and send the conversation ID as first message instead
-                  of the character name. The format is{" "}
-                  <code style={{ color: "#fff0b9" }}>[sucker:conv=conversationId]</code> which you'll be
-                  given when creating a new card.
-                </li>
-                <li className="mb-2">
-                  You can also send more messages with possible keywords to trigger scripts/lorebooks. Sucker will track changes to the description and scenario fields. Cards with multiple versions will show a version badge and offer a "Download Changes" button to get a detailed change
-                  history with timestamps. Unfortunately, lorebook creation is out of scope at the moment, but you can use the changes detected to modify the character card yourself post-export.
-                </li>
-                <li className="mb-2">
-                  Download the JSON files or go through a little more effort to
-                  get PNGs instead.
-                </li>
-              </ol>
-              <p className="mb-2">
-                Extractions will only last for 10 minutes, after which they're
-                discarded. Reloading the page will remove any attached avatars.
-                I'm not storing shit.
-              </p>
             </div>
-          </CollapsibleContent>
+
-        </Collapsible>
+            {/* Mobile: carousel */}
+            <BannerCarousel
+              className="md:hidden mb-4"
+              slides={[
+                <DiscordBannerPermanent
+                  key="avalon"
+                  inviteLink="https://discord.gg/5jQKkCfHP3"
+                  serverName="Avalon"
+                  description="Avalon is an enchanted creative haven for a growing collective of botmakers and users—part workshop, part myth, part digital forest where strange and beautiful ideas come to life. Enter our little woodland here:"
+                  ctaText="Join Server"
+                  className="h-full"
+                />,
+                <CssEditorBanner key="css" className="h-full" fit="contain" />,
+              ]}
+            />
+          </>
+        )}
 
         <div className="max-w-3xl mx-auto space-y-6">
           {cards.length === 0 ? (
@@ -482,71 +516,70 @@ export default function Home() {
                         <div id={`card-${index}`} className="space-y-4 mt-4">
                           {(card.initialVersion?.description ||
                             card.data?.description) && (
-                            <Accordion type="single" collapsible>
+                              <Accordion type="single" collapsible>
-                              <AccordionItem value="description">
+                                <AccordionItem value="description">
-                                <AccordionTrigger>Description</AccordionTrigger>
+                                  <AccordionTrigger>Description</AccordionTrigger>
-                                <AccordionContent>
+                                  <AccordionContent>
-                                  <div className="flex justify-between">
+                                    <div className="flex justify-between">
-                                    <pre className="whitespace-pre-wrap font-sans text-sm">
+                                      <pre className="whitespace-pre-wrap font-sans text-sm">
-                                      {card.initialVersion?.description ||
+                                        {card.initialVersion?.description ||
-                                        card.data.description}
+                                          card.data.description}
-                                    </pre>
+                                      </pre>
-                                    <Button
+                                      <Button
-                                      variant="ghost"
+                                        variant="ghost"
-                                      size="icon"
+                                        size="icon"
-                                      onClick={(e) => {
+                                        onClick={(e) => {
-                                        e.stopPropagation();
+                                          e.stopPropagation();
-                                        copyToClipboard(
+                                          copyToClipboard(
-                                          card.initialVersion?.description ||
+                                            card.initialVersion?.description ||
                                             card.data.description
-                                        );
+                                          );
-                                      }}
+                                        }}
-                                    >
+                                      >
-                                      <Copy className="h-4 w-4" />
+                                        <Copy className="h-4 w-4" />
-                                    </Button>
+                                      </Button>
-                                  </div>
+                                    </div>
-                                </AccordionContent>
+                                  </AccordionContent>
-                              </AccordionItem>
+                                </AccordionItem>
-                            </Accordion>
+                              </Accordion>
-                          )}
+                            )}
                           {(card.initialVersion?.first_mes ||
                             card.data?.first_mes) && (
-                            <Accordion type="single" collapsible>
+                              <Accordion type="single" collapsible>
-                              <AccordionItem value="first-message">
+                                <AccordionItem value="first-message">
-                                <AccordionTrigger>
+                                  <AccordionTrigger>
-                                  First Message
+                                    First Message
-                                </AccordionTrigger>
+                                  </AccordionTrigger>
-                                <AccordionContent>
+                                  <AccordionContent>
-                                  <div className="flex justify-between">
+                                    <div className="flex justify-between">
-                                    <pre className="whitespace-pre-wrap font-sans text-sm">
+                                      <pre className="whitespace-pre-wrap font-sans text-sm">
-                                      {card.initialVersion?.first_mes ||
+                                        {card.initialVersion?.first_mes ||
-                                        card.data.first_mes}
+                                          card.data.first_mes}
-                                    </pre>
+                                      </pre>
-                                    <Button
+                                      <Button
-                                      variant="ghost"
+                                        variant="ghost"
-                                      size="icon"
+                                        size="icon"
-                                      onClick={(e) => {
+                                        onClick={(e) => {
-                                        e.stopPropagation();
+                                          e.stopPropagation();
-                                        copyToClipboard(
+                                          copyToClipboard(
-                                          card.initialVersion?.first_mes ||
+                                            card.initialVersion?.first_mes ||
                                             card.data.first_mes
-                                        );
+                                          );
-                                      }}
+                                        }}
-                                    >
+                                      >
-                                      <Copy className="h-4 w-4" />
+                                        <Copy className="h-4 w-4" />
-                                    </Button>
+                                      </Button>
-                                  </div>
+                                    </div>
-                                </AccordionContent>
+                                  </AccordionContent>
-                              </AccordionItem>
+                                </AccordionItem>
-                            </Accordion>
+                              </Accordion>
-                          )}
+                            )}
                           {card.alternate_greetings &&
                             card.alternate_greetings.length > 0 && (
                               <div className="mt-4">
                                 <div className="flex items-center justify-between mb-2">
-                                  <h4 className="font-medium">{`Alternate Greetings (${
+                                  <h4 className="font-medium">{`Alternate Greetings (${card.alternate_greetings?.length || 0
-                                    card.alternate_greetings?.length || 0
+                                    })`}</h4>
-                                  })`}</h4>
                                   <div className="flex items-center gap-2">
                                     <Button
                                       variant="ghost"
@@ -615,93 +648,93 @@ export default function Home() {
                             )}
                           {(card.initialVersion?.scenario ||
                             card.data?.scenario) && (
-                            <Accordion type="single" collapsible>
+                              <Accordion type="single" collapsible>
-                              <AccordionItem value="scenario">
+                                <AccordionItem value="scenario">
-                                <AccordionTrigger>Scenario</AccordionTrigger>
+                                  <AccordionTrigger>Scenario</AccordionTrigger>
-                                <AccordionContent>
+                                  <AccordionContent>
-                                  <div className="flex justify-between">
+                                    <div className="flex justify-between">
-                                    <pre className="whitespace-pre-wrap font-sans text-sm">
+                                      <pre className="whitespace-pre-wrap font-sans text-sm">
-                                      {card.initialVersion?.scenario ||
+                                        {card.initialVersion?.scenario ||
-                                        card.data.scenario}
+                                          card.data.scenario}
-                                    </pre>
+                                      </pre>
-                                    <Button
+                                      <Button
-                                      variant="ghost"
+                                        variant="ghost"
-                                      size="icon"
+                                        size="icon"
-                                      onClick={(e) => {
+                                        onClick={(e) => {
-                                        e.stopPropagation();
+                                          e.stopPropagation();
-                                        copyToClipboard(
+                                          copyToClipboard(
-                                          card.initialVersion?.scenario ||
+                                            card.initialVersion?.scenario ||
                                             card.data.scenario
-                                        );
+                                          );
-                                      }}
+                                        }}
-                                    >
+                                      >
-                                      <Copy className="h-4 w-4" />
+                                        <Copy className="h-4 w-4" />
-                                    </Button>
+                                      </Button>
-                                  </div>
+                                    </div>
-                                </AccordionContent>
+                                  </AccordionContent>
-                              </AccordionItem>
+                                </AccordionItem>
-                            </Accordion>
+                              </Accordion>
-                          )}
+                            )}
                           {(card.initialVersion?.mes_example ||
                             card.data?.mes_example) && (
-                            <Accordion type="single" collapsible>
+                              <Accordion type="single" collapsible>
-                              <AccordionItem value="example-messages">
+                                <AccordionItem value="example-messages">
-                                <AccordionTrigger>
+                                  <AccordionTrigger>
-                                  Example Messages
+                                    Example Messages
-                                </AccordionTrigger>
+                                  </AccordionTrigger>
-                                <AccordionContent>
+                                  <AccordionContent>
-                                  <div className="flex justify-between">
+                                    <div className="flex justify-between">
-                                    <pre className="whitespace-pre-wrap font-sans text-sm">
+                                      <pre className="whitespace-pre-wrap font-sans text-sm">
-                                      {card.initialVersion?.mes_example ||
+                                        {card.initialVersion?.mes_example ||
-                                        card.data.mes_example}
+                                          card.data.mes_example}
-                                    </pre>
+                                      </pre>
-                                    <Button
+                                      <Button
-                                      variant="ghost"
+                                        variant="ghost"
-                                      size="icon"
+                                        size="icon"
-                                      onClick={(e) => {
+                                        onClick={(e) => {
-                                        e.stopPropagation();
+                                          e.stopPropagation();
-                                        copyToClipboard(
+                                          copyToClipboard(
-                                          card.initialVersion?.mes_example ||
+                                            card.initialVersion?.mes_example ||
                                             card.data.mes_example
-                                        );
+                                          );
-                                      }}
+                                        }}
-                                    >
+                                      >
-                                      <Copy className="h-4 w-4" />
+                                        <Copy className="h-4 w-4" />
-                                    </Button>
+                                      </Button>
-                                  </div>
+                                    </div>
-                                </AccordionContent>
+                                  </AccordionContent>
-                              </AccordionItem>
+                                </AccordionItem>
-                            </Accordion>
+                              </Accordion>
-                          )}
+                            )}
                           {(card.initialVersion?.personality ||
                             card.data?.personality) && (
-                            <Accordion type="single" collapsible>
+                              <Accordion type="single" collapsible>
-                              <AccordionItem value="personality">
+                                <AccordionItem value="personality">
-                                <AccordionTrigger>Personality</AccordionTrigger>
+                                  <AccordionTrigger>Personality</AccordionTrigger>
-                                <AccordionContent>
+                                  <AccordionContent>
-                                  <div className="flex justify-between">
+                                    <div className="flex justify-between">
-                                    <pre className="whitespace-pre-wrap font-sans text-sm">
+                                      <pre className="whitespace-pre-wrap font-sans text-sm">
-                                      {card.initialVersion?.personality ||
+                                        {card.initialVersion?.personality ||
-                                        card.data.personality}
+                                          card.data.personality}
-                                    </pre>
+                                      </pre>
-                                    <Button
+                                      <Button
-                                      variant="ghost"
+                                        variant="ghost"
-                                      size="icon"
+                                        size="icon"
-                                      onClick={(e) => {
+                                        onClick={(e) => {
-                                        e.stopPropagation();
+                                          e.stopPropagation();
-                                        copyToClipboard(
+                                          copyToClipboard(
-                                          card.initialVersion?.personality ||
+                                            card.initialVersion?.personality ||
                                             card.data.personality
-                                        );
+                                          );
-                                      }}
+                                        }}
-                                    >
+                                      >
-                                      <Copy className="h-4 w-4" />
+                                        <Copy className="h-4 w-4" />
-                                    </Button>
+                                      </Button>
-                                  </div>
+                                    </div>
-                                </AccordionContent>
+                                  </AccordionContent>
-                              </AccordionItem>
+                                </AccordionItem>
-                            </Accordion>
+                              </Accordion>
-                          )}
+                            )}
                         </div>
                       </AccordionContent>
                     </AccordionItem>
@@ -753,16 +786,325 @@ export default function Home() {
         </div>
       </div>
 
+      {/* How to Use Dialog */}
+      <Dialog open={howToUseDialogOpen} onOpenChange={setHowToUseDialogOpen}>
+        <DialogContent className="max-w-2xl max-h-[80vh] overflow-y-auto">
+          <DialogHeader>
+            <DialogTitle>How to Use</DialogTitle>
+            <DialogDescription>
+              Follow every instruction here to the letter because it&apos;s all you
+              need to know and I have no intent of helping you further.
+            </DialogDescription>
+          </DialogHeader>
+          <div className="prose dark:prose-invert max-w-none">
+            <ol className="list-decimal list-inside space-y-3 text-sm">
+              <li>
+                Put <code className="bg-muted px-1 py-0.5 rounded text-yellow-600">{proxyUrl}</code> in
+                your API settings, any value for model and key.
+              </li>
+              <li>
+                REQUIRED: Set your custom prompt to{" "}
+                <code className="bg-muted px-1 py-0.5 rounded text-yellow-600">&lt;.&gt;</code>
+              </li>
+              <li>
+                REQUIRED: Set your persona (or create a new one) with the name{" "}
+                <code className="bg-muted px-1 py-0.5 rounded text-yellow-600">&#123;user&#125;</code> and
+                the description should only have{" "}
+                <code className="bg-muted px-1 py-0.5 rounded text-yellow-600">.</code> in it.
+              </li>
+              <li>
+                Save settings and refresh the page. Not this page. <i>That</i>{" "}
+                page.
+              </li>
+              <li>Start a new chat with a character.</li>
+              <li>
+                Char name inference is implemented: if you send just a dot:{" "}
+                <code className="bg-muted px-1 py-0.5 rounded text-yellow-600">.</code>, sucker will use
+                the inferred name from the persona tag, or you can send the
+                character name yourself.
+              </li>
+              <li>
+                Hit the Refresh button here, and the cards should appear here.
+              </li>
+              <li>
+                If you&apos;re interested in capturing alternate greetings, start a
+                new chat and send the conversation ID as first message instead
+                of the character name. The format is{" "}
+                <code className="bg-muted px-1 py-0.5 rounded text-yellow-600">
+                  [sucker:conv=conversationId]
+                </code>{" "}
+                which you&apos;ll be given when creating a new card.
+              </li>
+              <li>
+                You can also send more messages with possible keywords to
+                trigger scripts/lorebooks. Sucker will track changes to the
+                description and scenario fields. Cards with multiple versions
+                will show a version badge and offer a &quot;Download Changes&quot;
+                button to get a detailed change history with timestamps.
+                Unfortunately, lorebook creation is out of scope at the
+                moment, but you can use the changes detected to modify the
+                character card yourself post-export.
+              </li>
+              <li>
+                Some advanced scripts and lorebooks only add their entries
+                when the <i>character</i> says the keyword, not you. Put{" "}
+                <code className="bg-muted px-1 py-0.5 rounded text-yellow-600">ECHO:</code>{" "}
+                in a message and everything after it gets repeated at the end
+                of the reply — instant character-side keywords, and sucker
+                tracks whatever gets added.
+              </li>
+              <li>
+                Download the JSON files or go through a little more effort to
+                get PNGs instead.
+              </li>
+            </ol>
+            <p className="mt-4 text-sm text-muted-foreground">
+              Extractions will only last for 10 minutes, after which they&apos;re
+              discarded. Reloading the page will remove any attached avatars.
+              I&apos;m not storing shit.
+            </p>
+          </div>
+        </DialogContent>
+      </Dialog>
+
+      {/* Mirrors Dialog */}
+      <Dialog open={mirrorsDialogOpen} onOpenChange={setMirrorsDialogOpen}>
+        <DialogContent>
+          <DialogHeader>
+            <DialogTitle>Sucker Mirrors</DialogTitle>
+            <DialogDescription>
+              Sucker goes down sometimes on severian.dev because I use the
+              server for other stuff. Here&apos;s a full list of existing sucker
+              instances (thanks to those who signed up for it!):
+            </DialogDescription>
+          </DialogHeader>
+          <div className="space-y-2">
+            <ul className="text-sm flex flex-col gap-2">
+              <li>
+                <a
+                  className="text-yellow-600 hover:underline"
+                  href="https://sucker.severian.dev"
+                  target="_blank"
+                  rel="noopener noreferrer"
+                >
+                  severian.dev
+                </a>
+              </li>
+              <li>
+                <a
+                  className="text-yellow-600 hover:underline"
+                  href="https://sucker.trashpanda.land"
+                  target="_blank"
+                  rel="noopener noreferrer"
+                >
+                  trashpanda.land
+                </a>
+              </li>
+              <li>
+                <a
+                  className="text-yellow-600 hover:underline"
+                  href="https://sucker.hitani.me"
+                  target="_blank"
+                  rel="noopener noreferrer"
+                >
+                  hitani.me
+                </a>
+              </li>
+              <li>
+                <a
+                  className="text-yellow-600 hover:underline"
+                  href="https://succ.portalnexus.link"
+                  target="_blank"
+                  rel="noopener noreferrer"
+                >
+                  portalnexus.link
+                </a>
+              </li>
+              <li>
+                <a
+                  className="text-yellow-600 hover:underline"
+                  href="https://sucker.lemuria.dev"
+                  target="_blank"
+                  rel="noopener noreferrer"
+                >
+                  lemuria.dev
+                </a>
+              </li>
+              <li>
+                <a
+                  className="text-yellow-600 hover:underline"
+                  href="https://milker.ladyofpa.in/"
+                  target="_blank"
+                  rel="noopener noreferrer"
+                >
+                  ladyofpa.in
+                </a>
+              </li>
+            </ul>
+            <p className="text-sm text-muted-foreground pt-4">
+              If you&apos;re interested in hosting your own sucker instance, lmk
+              via Discord: @lyseverian, I&apos;ve made the GH repo private for
+              now. Or send me a message if there&apos;s anything you think that
+              could be added here, open to suggestions.
+            </p>
+          </div>
+        </DialogContent>
+      </Dialog>
+
+      {/* Changelog Dialog */}
+      <Dialog open={changelogDialogOpen} onOpenChange={setChangelogDialogOpen}>
+        <DialogContent className="max-w-2xl max-h-[80vh] overflow-y-auto">
+          <DialogHeader>
+            <DialogTitle>Changelog</DialogTitle>
+            <DialogDescription>
+              Recent updates and changes to Sucker
+            </DialogDescription>
+          </DialogHeader>
+          <div className="space-y-6">
+            <div>
+              <h3 className="font-semibold text-lg mb-2">Sep 2026 - CSS Editor for Janitor profiles</h3>
+              <div className="space-y-2 text-sm text-muted-foreground">
+                <p>
+                  We&apos;d like to introduce a CSS editor we have been working
+                  on for Janitor profiles. It comes loaded with some simple
+                  presets, and we plan to include more in the future, be it
+                  ours or provided by the community. You can see changes occur
+                  in live time and it should accurately represent the
+                  behaviour of the CSS if used in your Janitor profile.
+                </p>
+                <p>
+                  Check it out at{" "}
+                  <a
+                    href="https://tools.from-avalon.com/janitor-profile-maker/"
+                    target="_blank"
+                    rel="noopener noreferrer"
+                    className="text-blue-500 hover:underline"
+                  >
+                    tools.from-avalon.com/janitor-profile-maker
+                  </a>{" "}
+                  and DM eslezer on Discord if you have any bug or suggestion
+                  for the editor.
+                </p>
+              </div>
+            </div>
+            <Separator />
+            <div>
+              <h3 className="font-semibold text-lg mb-2">Aug 2026 - ECHO</h3>
+              <div className="space-y-2 text-sm text-muted-foreground">
+                <p>
+                  Sucker can parrot now. Send a message with ECHO: in it, and
+                  everything after that gets repeated back at the end of the
+                  reply, exactly as you typed it.
+                </p>
+                <p>
+                  The usual responses don&apos;t change at all — the echoed part
+                  just tags along after them. The point: some of the fancier
+                  scripts and lorebooks on the platform you suck from only add
+                  their entries when the character says the keyword, not you.
+                  ECHO plants your words on the character&apos;s side of the
+                  chat, those entries fire, and sucker catches whatever they
+                  sneak in. Case doesn&apos;t matter, echo: works too.
+                </p>
+              </div>
+            </div>
+            <Separator />
+            <div>
+              <h3 className="font-semibold text-lg mb-2">Mar 2026 - Better error messaging for context size issues</h3>
+              <div className="space-y-2 text-sm text-muted-foreground">
+                <p>
+                  Identified an issue where attempting to pull bots with token counts
+                  greater than your configured context size would result in a dingus error
+                  with no useful explanation.
+                </p>
+                <p>
+                  Revised the error message to surface this more accurately. It now
+                  tells you to bump your Context Size in Generation Settings if you
+                  suspect this is the cause.
+                </p>
+              </div>
+            </div>
+            <Separator />
+            <div>
+              <h3 className="font-semibold text-lg mb-2">Jan 2026 - Direct image input</h3>
+              <div className="space-y-2 text-sm text-muted-foreground">
+                <p>
+                  You can now paste webp filenames (like id.webp) or full image URLs
+                  directly into the avatar field without having to open the metadata tab first.
+                </p>
+                <p>
+                  Makes grabbing avatars way faster when you already know the image path.
+                </p>
+                <p>
+                  You should also consider joining our new thing, a Discord community server for botmakers:{" "}
+                  <a
+                    href="https://discord.gg/5jQKkCfHP3"
+                    target="_blank"
+                    rel="noopener noreferrer"
+                    className="text-primary hover:underline"
+                  >
+                    discord.gg/5jQKkCfHP3
+                  </a>
+                </p>
+              </div>
+            </div>
+            <Separator />
+            <div>
+              <h3 className="font-semibold text-lg mb-2">Dec 2025 - A note about fetching avatars</h3>
+              <div className="space-y-2 text-sm text-muted-foreground">
+                <p>
+                  The platform you suck from has implemented limited visibility
+                  of metadata for certain content with a particular &apos;obscenity
+                  rating&apos;. This means that in some cases, the Fetch Avatar flow
+                  here will show a 404 - character not found error at the end.
+                </p>
+                <p>
+                  Sometimes (but not always), the avatar URL can still be
+                  fetched after a day or two since the bot was published.
+                </p>
+                <p>
+                  As of this moment, can&apos;t really find a fix for it, so you&apos;ll
+                  have to download the image yourself and just add the image to
+                  the card someplace else.
+                </p>
+              </div>
+            </div>
+            <Separator />
+            <div>
+              <h3 className="font-semibold text-lg mb-2">
+                Oct 2025 - V2 charcard format, multi-turn support
+              </h3>
+              <div className="text-sm text-muted-foreground space-y-2">
+                <p>
+                  Sucker now tracks changes to character descriptions and
+                  scenarios across multiple messages. Cards with multiple versions
+                  show a version badge and offer a &quot;Download Changes&quot; button to
+                  get the change history.
+                </p>
+                <p>
+                  Alternate greetings are also supported. Sucker will provide you
+                  with a conversation ID that you can use to start off a new chat
+                  when capturing alternate greetings, send it as first message
+                  instead of the character name.
+                </p>
+                <p>
+                  Directions are updated below. Make sure you read &apos;em.
+                </p>
+              </div>
+            </div>
+          </div>
+        </DialogContent>
+      </Dialog>
+
       <Dialog open={dialogOpen} onOpenChange={setDialogOpen}>
         <DialogContent>
           <DialogHeader>
             <DialogTitle>
-              {isMetadataOpen ? "Enter Avatar Path" : "Enter Character URL"}
+              {isMetadataOpen ? "Enter Avatar Path" : "Fetch Avatar"}
             </DialogTitle>
             <DialogDescription>
               {isMetadataOpen
                 ? "Look for the avatar field in the opened tab and paste the value here."
-                : "Enter the Janitor character URL (https://janitorai.com/characters/...)."}
+                : "Enter a character URL (janitorai.com/characters/...) to open metadata, or paste an image filename (id.webp) or full image URL directly."}
             </DialogDescription>
           </DialogHeader>
 
@@ -782,19 +1124,18 @@ export default function Home() {
           ) : (
             <div className="space-y-4">
               <Input
-                placeholder="https://janitorai.com/characters/..."
+                placeholder="URL or id.webp"
                 value={characterUrl}
                 onChange={(e: React.ChangeEvent<HTMLInputElement>) =>
                   setCharacterUrl(e.target.value)
                 }
               />
               <p className="text-sm text-muted-foreground">
-                Upon clicking this button, a new tab will open with the
+                For character URLs, a new tab will open with metadata. For image
-                character's metadata. Look for the avatar field and copy the
+                filenames or full image URLs, the avatar will be set directly.
-                value before returning to this page.
               </p>
               <Button onClick={handleOpenMetadata} className="w-full">
-                Open Metadata
+                Fetch Avatar
               </Button>
             </div>
           )}

src/components/ui/banner-carousel.tsx

@@ -0,0 +1,85 @@
+"use client";
+
+import { useState, useEffect, ReactNode } from "react";
+import { ChevronLeft, ChevronRight } from "lucide-react";
+
+interface BannerCarouselProps {
+  slides: ReactNode[];
+  intervalMs?: number;
+  className?: string;
+}
+
+export function BannerCarousel({
+  slides,
+  intervalMs = 8000,
+  className = "",
+}: BannerCarouselProps) {
+  const [index, setIndex] = useState(0);
+
+  // Pick a random starting slide on the client to avoid hydration mismatch
+  useEffect(() => {
+    setIndex(Math.floor(Math.random() * slides.length));
+  }, [slides.length]);
+
+  // Re-keyed on index so a manual change restarts the countdown
+  useEffect(() => {
+    const id = setTimeout(
+      () => setIndex((i) => (i + 1) % slides.length),
+      intervalMs
+    );
+    return () => clearTimeout(id);
+  }, [index, intervalMs, slides.length]);
+
+  const go = (delta: number) =>
+    setIndex((i) => (i + delta + slides.length) % slides.length);
+
+  return (
+    <div className={`relative ${className}`}>
+      {/* Slides stacked in one grid cell so the container fits the tallest */}
+      <div className="grid">
+        {slides.map((slide, i) => (
+          <div
+            key={i}
+            className={`[grid-area:1/1] transition-opacity duration-500 ${
+              i === index ? "opacity-100" : "opacity-0 pointer-events-none"
+            }`}
+            aria-hidden={i !== index}
+          >
+            {slide}
+          </div>
+        ))}
+      </div>
+
+      <button
+        type="button"
+        onClick={() => go(-1)}
+        aria-label="Previous banner"
+        className="absolute left-1.5 top-1/2 -translate-y-1/2 rounded-full bg-black/50 hover:bg-black/70 text-white p-1 transition-colors"
+      >
+        <ChevronLeft className="h-4 w-4" />
+      </button>
+      <button
+        type="button"
+        onClick={() => go(1)}
+        aria-label="Next banner"
+        className="absolute right-1.5 top-1/2 -translate-y-1/2 rounded-full bg-black/50 hover:bg-black/70 text-white p-1 transition-colors"
+      >
+        <ChevronRight className="h-4 w-4" />
+      </button>
+
+      <div className="absolute bottom-2 left-1/2 -translate-x-1/2 flex gap-1.5">
+        {slides.map((_, i) => (
+          <button
+            key={i}
+            type="button"
+            onClick={() => setIndex(i)}
+            aria-label={`Show banner ${i + 1}`}
+            className={`h-1.5 rounded-full transition-all ${
+              i === index ? "w-4 bg-white" : "w-1.5 bg-white/50"
+            }`}
+          />
+        ))}
+      </div>
+    </div>
+  );
+}

src/components/ui/css-editor-banner.tsx

@@ -0,0 +1,100 @@
+"use client";
+
+import { useEffect, useRef } from "react";
+
+interface CssEditorBannerProps {
+  href?: string;
+  className?: string;
+  /** "contain" letterboxes the video so its caption is never cropped */
+  fit?: "cover" | "contain";
+}
+
+export function CssEditorBanner({
+  href = "https://tools.from-avalon.com/janitor-profile-maker/",
+  className = "",
+  fit = "cover",
+}: CssEditorBannerProps) {
+  const videoRef = useRef<HTMLVideoElement>(null);
+  const canvasRef = useRef<HTMLCanvasElement>(null);
+
+  // Browsers like Opera GX overlay pop-out controls on large <video> elements.
+  // The real video stays 1px and invisible; its frames are painted onto a canvas.
+  useEffect(() => {
+    const video = videoRef.current;
+    const canvas = canvasRef.current;
+    const ctx = canvas?.getContext("2d");
+    if (!video || !canvas || !ctx) return;
+
+    const resize = () => {
+      const dpr = window.devicePixelRatio || 1;
+      canvas.width = Math.round(canvas.clientWidth * dpr);
+      canvas.height = Math.round(canvas.clientHeight * dpr);
+    };
+    resize();
+    const observer = new ResizeObserver(resize);
+    observer.observe(canvas);
+
+    let frame = 0;
+    const draw = () => {
+      const vw = video.videoWidth;
+      const vh = video.videoHeight;
+      const cw = canvas.width;
+      const ch = canvas.height;
+      if (vw && vh && cw && ch) {
+        const scale =
+          fit === "contain"
+            ? Math.min(cw / vw, ch / vh)
+            : Math.max(cw / vw, ch / vh);
+        const w = vw * scale;
+        const h = vh * scale;
+        ctx.clearRect(0, 0, cw, ch);
+        ctx.drawImage(video, (cw - w) / 2, (ch - h) / 2, w, h);
+      }
+      frame = requestAnimationFrame(draw);
+    };
+    frame = requestAnimationFrame(draw);
+
+    // Browsers may pause muted videos they consider hidden; keep it looping.
+    const resume = () => {
+      if (video.paused && document.visibilityState === "visible") {
+        video.play().catch(() => {});
+      }
+    };
+    resume();
+    video.addEventListener("pause", resume);
+    document.addEventListener("visibilitychange", resume);
+    const keepAlive = setInterval(resume, 1000);
+
+    return () => {
+      cancelAnimationFrame(frame);
+      observer.disconnect();
+      clearInterval(keepAlive);
+      video.removeEventListener("pause", resume);
+      document.removeEventListener("visibilitychange", resume);
+    };
+  }, [fit]);
+
+  return (
+    <a
+      href={href}
+      target="_blank"
+      rel="noopener noreferrer"
+      aria-label="Open the Janitor profile CSS editor"
+      className={`block relative rounded-lg overflow-hidden shadow-lg bg-black ${className}`}
+    >
+      <video
+        ref={videoRef}
+        src="/avalon/css-banner.mp4"
+        autoPlay
+        loop
+        muted
+        playsInline
+        disablePictureInPicture
+        preload="auto"
+        aria-hidden
+        className="absolute top-0 left-0 w-px h-px opacity-[0.01] pointer-events-none"
+      />
+      <canvas ref={canvasRef} className="absolute inset-0 w-full h-full" />
+    </a>
+  );
+}

src/components/ui/discord-banner-permanent.tsx

@@ -0,0 +1,112 @@
+"use client";
+
+import Image from "next/image";
+
+interface DiscordBannerPermanentProps {
+  inviteLink: string;
+  serverName?: string;
+  description?: string;
+  ctaText?: string;
+  className?: string;
+}
+
+export function DiscordBannerPermanent({
+  inviteLink,
+  serverName = "Avalon",
+  description = "Avalon is an enchanted creative haven for a growing collective of botmakers and users—part workshop, part myth, part digital forest where strange and beautiful ideas come to life. Enter our little woodland here:",
+  ctaText = "Join Server",
+  className = "mb-4",
+}: DiscordBannerPermanentProps) {
+  return (
+    <div className={`relative rounded-lg overflow-hidden shadow-lg bg-[#36393f] ${className}`}>
+      {/* Background Image */}
+      <div className="absolute inset-0">
+        <Image
+          src="/avalon/bg.webp"
+          alt="Background"
+          fill
+          className="object-cover opacity-20"
+        />
+      </div>
+
+      {/* Content */}
+      <div className="relative p-3 sm:p-4">
+        {/* Chat Message Style */}
+        <div className="flex gap-3 mb-2">
+          {/* Morgana Avatar */}
+          <div className="flex-shrink-0 pt-0.5">
+            <Image
+              src="/avalon/morgana-thumb.webp"
+              alt="Morgana"
+              width={40}
+              height={40}
+              className="rounded-full w-10 h-10"
+            />
+          </div>
+
+          {/* Message Content */}
+          <div className="flex-1 min-w-0">
+            <div className="flex items-baseline gap-2 mb-0.5">
+              <span className="text-white font-medium text-[15px]">Morgana</span>
+              <span className="text-[#a3a6aa] text-[11px] font-medium">Today at {new Date().toLocaleTimeString('en-US', { hour: 'numeric', minute: '2-digit', hour12: true })}</span>
+            </div>
+            <div className="text-[#dcddde] text-[15px] leading-[1.375rem] mb-2">
+              {description}
+            </div>
+
+            {/* Server Invite Embed */}
+            <div className="bg-[#2f3136] rounded border-l-4 border-[#5865F2] overflow-hidden max-w-[432px]">
+              <div className="p-4 pb-3">
+                <div className="text-[#00b0f4] text-xs font-semibold uppercase mb-2">
+                  You&apos;ve been invited to join a server
+                </div>
+                <div className="flex items-center gap-4">
+                  <Image
+                    src="/avalon/avalon-pfp.webp"
+                    alt="Avalon"
+                    width={50}
+                    height={50}
+                    className="rounded-2xl w-[50px] h-[50px] flex-shrink-0"
+                  />
+                  <div className="flex-1 min-w-0">
+                    <div className="text-white font-semibold text-base mb-0.5">{serverName}</div>
+                    <div className="text-[#b9bbbe] text-sm space-y-0.5">
+                      <div className="font-medium">885 members</div>
+                      <a
+                        href="https://from-avalon.com"
+                        target="_blank"
+                        rel="noopener noreferrer"
+                        className="text-[#00aff4] hover:underline text-xs inline-block"
+                      >
+                        from-avalon.com
+                      </a>
+                    </div>
+                  </div>
+                  <a
+                    href={inviteLink}
+                    target="_blank"
+                    rel="noopener noreferrer"
+                    className="bg-[#248046] hover:bg-[#1a6334] text-white px-4 py-2 text-sm rounded font-medium transition-colors flex-shrink-0"
+                  >
+                    {ctaText}
+                  </a>
+                </div>
+              </div>
+            </div>
+          </div>
+        </div>
+
+        {/* Trash Panda Icon - Bottom Right */}
+        <div className="absolute bottom-1.5 right-1.5">
+          <Image
+            src="/avalon/trashpanda.webp"
+            alt=""
+            width={20}
+            height={20}
+            className="rounded-full w-5 h-5 ring-1 ring-black/20 opacity-60 hover:opacity-100 transition-opacity"
+          />
+        </div>
+      </div>
+    </div>
+  );
+}

src/components/ui/dropdown-menu.tsx

@@ -0,0 +1,41 @@
+"use client";
+
+import * as React from "react";
+import * as DropdownMenuPrimitive from "@radix-ui/react-dropdown-menu";
+
+const DropdownMenu = DropdownMenuPrimitive.Root;
+
+const DropdownMenuTrigger = DropdownMenuPrimitive.Trigger;
+
+const DropdownMenuContent = React.forwardRef<
+  React.ElementRef<typeof DropdownMenuPrimitive.Content>,
+  React.ComponentPropsWithoutRef<typeof DropdownMenuPrimitive.Content>
+>(({ className = "", sideOffset = 4, ...props }, ref) => (
+  <DropdownMenuPrimitive.Portal>
+    <DropdownMenuPrimitive.Content
+      ref={ref}
+      sideOffset={sideOffset}
+      className={`z-50 min-w-[8rem] overflow-hidden rounded-md border bg-popover p-1 text-popover-foreground shadow-md animate-in data-[side=bottom]:slide-in-from-top-2 data-[side=left]:slide-in-from-right-2 data-[side=right]:slide-in-from-left-2 data-[side=top]:slide-in-from-bottom-2 ${className}`}
+      {...props}
+    />
+  </DropdownMenuPrimitive.Portal>
+));
+DropdownMenuContent.displayName = DropdownMenuPrimitive.Content.displayName;
+
+const DropdownMenuItem = React.forwardRef<
+  React.ElementRef<typeof DropdownMenuPrimitive.Item>,
+  React.ComponentPropsWithoutRef<typeof DropdownMenuPrimitive.Item> & {
+    inset?: boolean;
+  }
+>(({ className = "", inset, ...props }, ref) => (
+  <DropdownMenuPrimitive.Item
+    ref={ref}
+    className={`relative flex cursor-pointer select-none items-center rounded-sm px-2 py-1.5 text-sm outline-none transition-colors focus:bg-accent focus:text-accent-foreground data-[disabled]:pointer-events-none data-[disabled]:opacity-50 ${
+      inset ? "pl-8" : ""
+    } ${className}`}
+    {...props}
+  />
+));
+DropdownMenuItem.displayName = DropdownMenuPrimitive.Item.displayName;
+
+export { DropdownMenu, DropdownMenuTrigger, DropdownMenuContent, DropdownMenuItem };

tsconfig.json

@@ -2,8 +2,14 @@
   "compilerOptions": {
     "baseUrl": ".",
     "target": "es5",
-    "lib": ["dom", "dom.iterable", "esnext"],
+    "lib": [
-    "types": ["node"],
+      "dom",
+      "dom.iterable",
+      "esnext"
+    ],
+    "types": [
+      "node"
+    ],
     "allowJs": true,
     "skipLibCheck": true,
     "strict": true,
@@ -13,7 +19,7 @@
     "moduleResolution": "bundler",
     "resolveJsonModule": true,
     "isolatedModules": true,
-    "jsx": "preserve",
+    "jsx": "react-jsx",
     "incremental": true,
     "plugins": [
       {
@@ -21,9 +27,19 @@
       }
     ],
     "paths": {
-      "@/*": ["./src/*"]
+      "@/*": [
+        "./src/*"
+      ]
     }
   },
-  "include": ["next-env.d.ts", "**/*.ts", "**/*.tsx", ".next/types/**/*.ts"],
+  "include": [
-  "exclude": ["node_modules"]
+    "next-env.d.ts",
-} 
+    "**/*.ts",
+    "**/*.tsx",
+    ".next/types/**/*.ts",
+    ".next/dev/types/**/*.ts"
+  ],
+  "exclude": [
+    "node_modules"
+  ]
+}