English

Mimi Arigato

A tiny cat who remembers your life.

Translation pending

HealthJavaScript · CSSGitHub @vantrangaofOnlineOwner unconfirmed

Visit project GitHub

Have you tried it? One tap is enough. No sign-in needed.

Availability: Online; 30-day uptime 100%
Latest code update: Oct 17; Active repository
Latest version: None
Contributors: 1; Forks 0
Listed on nomorevibe: Oct 12; Repository created October 2026

Languages

JavaScript 82.1%
CSS 11.2%
HTML 3.9%
PLpgSQL and others 2.8%

Updates0 updates

All

No updates detected yet. GitHub releases will appear here.

Comments

Newest first

···

GitHub issue delivery settings

Checking sign-in status.

Loading comments.

Mimi Arigato — nomorevibe

Introduction

This is a project to remind me of Xiao Mi and love

Taken from the repository README

README

Mimi Arigato

A tiny cat who remembers your life.

Every day, tell Mimi one small thing worth remembering. Mimi listens. Mimi remembers. Over time Mimi starts noticing the people you love, the things you like, the wishes you made and forgot, and little patterns in your life. The good things you tell Mimi are how Mimi gets to know you.

Notice → Tell Mimi → Mimi reacts → Mimi remembers → Mimi connects things → Mimi knows you

Mimi is a gentle pet: no hunger bars, no punishments, no streaks that break. Mimi looks a little sad on a day without a fish or water, and one treat cheers them right up. Missing a day takes nothing away. "Arigato" means thank you in Japanese; you can rename the cat (for example, Xiao Mi).

It's an installable web app (PWA). It works offline and without an account; sign in with your email to sync your good things to the cloud and across devices. Once you've told Mimi something, a Keep Mimi safe on this phone card suggests adding Mimi to the Home Screen (an install button on Android and Chrome, Share → Add to Home Screen steps on iPhone; "Not now" hides it for two weeks). Safari on iPhone can clear a website's data after about a week away, which signs you out; Home Screen apps are spared. Mimi also asks the browser to keep its data.

The five pillars

Pillar	What it does
Good things	Tell Mimi up to five good things a day. One is a good day; five is Mimi's favorite.
Mimi	A pixel cat with moods, reactions to what you write, idle habits, and a purr.
Memories	Mimi connects your good things into theories about you, remembers what happened a year ago, and keeps your wishes.
Little world	Mimi's room fills up with things as your good things add up, things from your own life, and treasures Mimi finds.
Scrapbook	Every so often Mimi keeps one of your good things as a scrapbook page.

What you can do

Meet Mimi

How Mimi works: a short guide opens by itself on your first visit, and any time from the ? button in the top bar.
A good thing to remember: every time you open the app (or come back to it after 30 minutes away), a pop-up brings back one of your past good things, with its photo and a line from Mimi. Something from this day in an earlier year comes first. Another one pulls a different one; Tell Mimi about today shows when you haven't told Mimi anything yet today.
A new note every visit: under Mimi's name there's a little note in their voice ("Small things count. Especially snacks."). About 60 notes are dealt in shuffled order with no repeats; some fit the time of day, and some are personal (your name, your favorite things, a past good thing, days together). Tap the note for another.
On your first visit Mimi says hello and asks "What's your name?" Mimi then greets you by name ("Good morning, Trang!", "you're back, Trang!"). Choose "Maybe later" to skip; you can add or change it in Settings.

Tell Mimi good things

Write up to five entries a day. Hearts fill as you go: "One is enough today" → "That's a good day" → "Mimi's favorite kind of day."
Mimi reacts to what you wrote, entirely on-device using keywords:
- coffee → "Mimi approves." · rain → "likes rainy windows too." · a friend or family → "thinks that sounds special."
- finished something → "is so proud of you." · someone was kind → "loves a little kindness."
- a hard day → "says that counts too." (Mimi never forces positivity)
- taxes → "doesn't understand taxes, but is proud of you."
If you write something you've written before, Mimi remembers: "remembers you wrote about this on Sep 28 too."
Mimi's good thing: after your first good thing of the day, Mimi shares one of their own ("my turn!": "A sunbeam moved onto the cushion."). It shows under the journal for the rest of the day. Lines only mention things Mimi actually has (room items, treasures, seasonal decorations).
Thank-you cards: when a good thing mentions someone (a name, or Mom, Dad, Grandma…), an envelope button appears next to it. It makes a 1080×1350 pixel card ("Thank you, Lin!") with your words, Mimi, and "with love from Trang & Mimi" to save or send. You can change who it's for.
One year ago today: on a date you wrote something in an earlier year, a small card at the top of the journal shows what you told Mimi then (with its photo), and Mimi says something about it: "You still like ramen. Some things are very reliable.", "Anna is still around. Mimi is glad.", or, if you made a wish that day that later came true, "…And then you did it." Mimi mentions it once when you open the app that day.
Wishes: when a good thing says "I want to…", "I'd love to…", "someday I'll…", "I wish I could…" or "my dream is to…", Mimi folds the wish into the jar ("folded your wish into the jar: “learn pottery.”"), and a little paper tag hangs on the jar. When a later good thing mentions the same thing ("Went to my first pottery class!"), Mimi says "remembers you wished to “learn pottery” on Oct 4, 2025. Did you just do it?!" Now and then the jar gives you a wish back instead of a star ("Still keeping it safe for you."). Removing the good thing that made a wish removes the wish.
Stuck? Tap "Stuck? Pick something to think about" for prompts: something tiny, someone who was kind, something that made you laugh, something delicious, something you're proud of, something cute, something beautiful, something worth remembering.

Days together and paw prints

The top bar shows "Day 37 together": how long you've known Mimi, which never resets.
Paw prints: a row of this week's days (Monday first) under "Tell Mimi something good". A day gets a paw print when you tell Mimi a good thing (or tap "Nothing special today"). Missed days show as naps ("z"), never as gaps. Under it: "4 paw prints this week · a 9-day run · longest 12". A run keeps going through up to 2 naps a week, so it only ends after a really quiet week, and nothing says it broke. Mimi cheers runs of 3, 7, 14, 30, 50, 100, 200 and 365 days once. Worked out from your good things (plus synced "Nothing special" days), so it follows you to new devices.
Milestones are celebrated once: Day 1 "nice to meet you", Day 7 "recognizes you now", Day 30 "knows some of your favorite things", Day 100, one year; and 50 / 100 / 250 / 500 / 1,000 good things.
After a few days away: "you're back! Mimi kept your room cozy while you were away."

Sticky notes (reminders)

A Sticky notes card under the journal: tell Mimi what you don't want to forget, in your own words. "text Mom tomorrow at 6", "pay bills on Friday", "pay rent on the 1st every month", "water the plants every Sunday", "dentist Oct 12 at 9:30am", "take out trash tonight", "call grandma in 3 days".
As you type, Mimi fills in the day, time and repeat (once, every day/week/month/year), and you can change them before tapping Give to Mimi. With no day the note is for today; "at 6" means 6 pm.
Mimi holds them: when you open the app with notes due, Mimi says "psst… is holding a note for you: “Text Mom.”", and a little yellow sticky note appears on the room's wall (tap it to jump to the notes). If the app is open at a note's time, Mimi taps your hand.
On each note: ✓ (Mimi: "hopes Mom says hi back.", "doesn't understand money, but is proud of you."), later (moves it to tomorrow), add to calendar (a calendar event with an alert, repeating if the note repeats), and ×. A repeating note moves on to its next day when checked.
Mimi never scolds: a note from an earlier day just says "from Oct 2". Coming up lists the next few notes.
With notifications turned on (Settings → Daily reminder), Mimi sends a note in the hour it's due: "Xiao Mi is holding a note for you: Text Mom". Otherwise the alert comes from your calendar app ("add to calendar"). Notes sync and are in backups.

Mimi, the cat

Tap Mimi to pet them: a meow or purr (real recordings), happy ^ ^ eyes, blush, tail wags, a floating heart, and a little line ("leans into your hand."). Sometimes Mimi recalls one of your past entries.
Sound on/off: speaker button at the top right (remembered). On iPhone, the ring/silent switch also mutes web sounds.
Idle habits: every so often Mimi grooms a paw, yawns, dozes, stretches, chases their tail, stares at you, looks out the window, watches the aquarium fish, admires their accessory, or sits by the journal "waiting to hear about your day."
Time of day: asleep 10 pm to 6 am ("z z z"; tap to wake). Morning stretch, lunchtime thoughts, evening "ready to hear about your day."
Fish, water, cuddles: each good thing you tell Mimi today earns one treat, in turn: a fish, then water, then a cuddle, then a fish again (up to 5 good things). Give them whenever you like (a fish drops in, a water drop, a purring snuggle). Filling both bowls takes two good things, or one and today's challenge.
Today's challenge: a card under the journal with one small thing to go and do, the same on every device: "Take photos of 3 different cats", "Take a selfie with Xiao Mi", "Find 3 pink things", "Look up! Take a photo of the sky", "Tell Mimi 3 good things today" (18 in all, picked by date). For photo challenges, tap Add a photo: when you're signed in, Mimi's AI looks at it ("ooh, a fluffy orange cat!" or "hmm, that looks like a loaf of bread to me."), and only a photo that shows the right thing fills a slot. Signed out or offline, Mimi trusts you. The same photo can't count twice. Photos that count are kept in Photos, captioned with the challenge. Finishing it earns a treat bag: one more fish, water and cuddle.
Food and water bowls: two little bowls on the floor of Mimi's room, full once you've given a fish or water today. From 9 am (or from the moment Mimi wakes up, if that bowl stayed empty all of yesterday), if a bowl is still empty, Mimi looks a little sad (droopy eyes, a tiny tear, a frown, a slow tail) and says "is sitting by their empty bowls…" (or, when you open the app after forgetting yesterday, "missed you yesterday. The bowls stayed empty."); the tray says the bowls are empty and how to earn a treat. The first fish or drink gets a big "yay!! was so hungry. Thank you! ♡". Never on your first day, never at night, and never worse than a little sad. "Nothing special today" always earns a fish, so there's always a way. Feeding syncs, so feeding on your phone fills the bowls on your laptop too.

Mimi's little world

Everything unlocks by total good things and never goes away:

Good things	Unlocks
5	Little flower (to wear)
15	Ribbon bow (to wear)
30	Tiny plant
40	Cozy scarf (to wear)
50	Cushion
75	Wall picture
100	Window (the sky outside follows the time of day)
120	Beret (to wear)
150	Bookshelf
200	Tiny crown (to wear)
250	Aquarium
500	Starry window

The journal shows what's next: "Next for Mimi's world: a cushion at 50 good things."
Things from your life: when something comes up in three good things, a small object for it appears in the room and Mimi says "has been noticing a theme. A coffee mug appeared in the room." There are 18: coffee mug, teapot, stack of books, radio, toy mouse (cats), dog bone, umbrella (rain), vase of flowers, little pot (cooking), noodle bowl, cupcake (sweets), suitcase (travel), beach ball (the sea), sneakers (walks and runs), camera (photos), game controller, paint palette (art), popcorn (movies). Four sit on the floor and two on a little wall shelf; with more than six, the most-mentioned ones show. Tap one for a line ("sniffs your coffee mug. Still warm."). They never go away.
Jar of good things: a jar on a shelf under the window fills with paper stars (one per 5 good things, up to 16). Tap it, or shake your phone, and Mimi pulls out a random past good thing and reads it to you. On iPhone, shaking asks for motion permission the first time you tap the jar. On days your diary weather is rainy or stormy, the stars glimmer and Mimi likes to sit by the jar. That's the only thing Mimi takes from the diary: the weather, never the words.
Your photo on the wall: once the wall picture is unlocked (75), it shows one of your photos, pixelated to match the room. It's your newest photo unless you choose one with Hang in Mimi's room in the photo viewer.
Weekly postcard: on Sundays Mimi leaves a postcard on the floor about the week (Monday to Sunday): how many good things, how often you laughed, who came up, what kept showing up, and Mimi's favorite of the week. It stays until the next one (Monday to Saturday you see last week's), sparkles until read, and Mimi says "mail!" once when it arrives.

Seasons: for a few days a year the room gets a decoration and the wardrobe gets costumes, then they go away until next year:

When	Room	Wardrobe
Halloween (Oct 18 to Nov 1)	pumpkin and a bat	witch hat, ghost costume
Christmas (Dec 18 to 26)	wreath	Santa hat
Lunar New Year (3 days before to 7 days after)	red lantern	lucky knot
The day you met Mimi, every year after the first	cake with a candle

Mimi mentions it once per event each year. Costumes come off automatically when the event ends.

Photos

Photos tab: add photos of you and your cat ("Add photos", several at once). Tap one to see it large, write a caption, or delete it.
Mimi looks at your photos: when you're signed in, every photo you share (in Photos, or attached to a good thing) gets a look from Mimi's AI, and Mimi says something about it: "ooh, is that ramen? can i have some." The line stays under the photo in the photo viewer and syncs. Older photos, or ones added offline, have an Ask Mimi about this photo button. When you add many photos at once, Mimi looks at the first 5.
Attach a photo to a good thing: tap the camera button next to the journal box; the photo shows beside that entry, in the calendar, on its scrapbook page, and as the monthly favorite.
Photos are shrunk on the device before saving (longest side 1600 px, plus a small thumbnail) and turned upright automatically.
When signed in, photos sync to a private Supabase Storage bucket; other devices download thumbnails right away and full images when opened.

Mimi's things (tabs)

Your cat's diary (the tab is named after your cat, like "Xiao Mi's diary"): a photo a day of your real cat, or of the two of you (pick Xiao Mi or Xiao Mi & me before adding it). The cat writes a line about it in their own voice: "Sat in the sunbeam. Refused to move. 10/10." When you're signed in, Mimi's AI looks at the photo and writes it; otherwise it's one of a few built-in lines. Change the words or Change the photo any time. Flip back with ‹ ›, or tap a page in the strip underneath. Pages sync, and the photos are in Photos too. (Your own private diary is now called My diary.)
Cat translator (the button at the top of your cat's diary): add a photo of your real cat, and Mimi's AI reads their body language ("slow blink, ears relaxed, tail curled around paws") and says what they mean, in a speech bubble over the photo: "I love you. Also, dinner was 4 minutes ago." plus a mood (loving, playful, sleepy, grumpy…). Each translation goes into your cat's phrasebook (synced) and the photo into Photos. A photo with no cat gets a remark but isn't kept. Needs you to be signed in.
Memories: Mimi's theories first: every few days (at most one every 3 days, after 10 good things) Mimi connects some of your good things into a numbered theory, mentions it when you open the app, and keeps it forever. Mimi looks for:
- people who are around when good things happen ("Good things happen suspiciously often when Anna is around."), who make you laugh, and what's better with whom ("Coffee is better with Lin, apparently."), plus family who keep showing up
- things that go together ("Coffee on a rainy day might be your favorite thing in the world. Just a theory.")
- things you've liked for a long time, and things that went quiet ("You used to talk about cooking a lot. Not since March. Mimi is just noticing. No pressure.")
- what kind of person you are, according to a cat ("A suspicious amount of your happiness is edible.", "You find good things even on hard days.")
- when good things happen (a weekday, mornings or late nights)
Theories never use percentages or scores, and never use the diary. Each one has You're onto something (it gets a ✓) and Nope (Mimi "has made an error. They quietly take it off the evidence board."; it's gone for good and never suggested again). Then What Mimi has learned ("Mimi thinks you really like coffee." "You talked about Lin 3 times. Mimi knows Lin must be important." "Your mom came up 4 times. That sounds special.") plus a of drawers Mimi sorts on their own: People, Food, Things you were proud of, Things that made you laugh, Beautiful moments, Kindness, Rest, Moving your body, Hard days you got through, Little things, Wishes in the jar, Wishes that came true, and Treasures Mimi found.

Settings

Your name, the cat's name, fur color (Strawberry, Peach, Cloud, Midnight, Snow).
Appearance: Day & night (default: light from 6 am, dark from 7 pm, like the sky in Mimi's window), Match my phone, Light or Dark. Follows you to your other devices.
Account & sync (also the Sign in / cloud button at the top): create an account with your email and a password (or sign in to an existing one), or tap Forgot your password? Email me a sign-in link to sign in with no password (a link, plus a code to type, which is what works in the Home Screen app on iPhone). Your good things sync to the cloud and to every device you sign in on. "Sync now" shows when it last synced. Signing out asks whether to keep a copy on this device or remove it (for shared devices).
Daily reminder: adds a repeating event to your calendar app. Or tap Turn on notifications (signed in; on iPhone, from the Home Screen app, iOS 16.4 or later): at your reminder time, on a day you haven't told Mimi anything yet, Mimi sends one gentle note ("Xiao Mi is sitting by their empty bowls… one good thing earns a fish."), never more than one a day. Sticky notes with a time arrive in their hour too. It's per device, follows the device's time zone, and is sent by api/nudge.mjs, which a GitHub Actions schedule (.github/workflows/nudge.yml) calls every hour.
Friends (when signed in): "Invite a friend" makes a code like ABC-234 and a link to share; a friend opens the link or types the code under "Have a code?" and says yes. Tap a friend to visit their room: their cat, unlocks, treasures, seasonal decor and things from their life. Never their good things, diary or photos. "Show my things to friends" hides your things from your life from visitors. Either of you can remove the friendship.
The cat café (when signed in): the Café button lists your café and each friend's, with how many cats are there right now. Inside, every cat present sits on a cushion. Tap someone's cat to pet them (hearts for everyone; "Bun pet Xiao Mi! ♡"), and chat: messages float above your cat and fill a little log. Everyone hosts a café, and only the host and the host's friends can come in, so you may meet a friend's other friends there. Live only: nothing is saved, and messages are gone when you leave. Built on private Supabase Realtime channels (cafe:<host id>), allowed by mimi_can_enter_cafe in supabase/schema.sql.
Chat with Mimi (when signed in): the Chat button opens a little conversation with your cat. Mimi knows your names, your recent good things and wishes (never your diary). The chat stays on this device.

Running it

No build step and no dependencies. Serve the folder with any static server:

python3 -m http.server 5173
# open http://localhost:5173

Project structure

index.html              Page markup (the room, journal, tabs, dialogs)
manifest.webmanifest    Install-to-home-screen metadata
sw.js                   Offline support (network first, cached copy when offline)
supabase/schema.sql     Cloud database tables and security rules (run once in Supabase)
api/mimi.mjs            Vercel function: Mimi's AI (good-thing check + chat, Gemini), 120 calls/person/day
assets/
  icon.svg              App icon (vector)
  icons/                PNG app icons (home screen, maskable, Apple touch, favicon)
  sounds/meow.m4a       0.9 s meow clip
  sounds/purr.m4a       1.5 s purr clip
styles/
  tokens.css            Colors, fonts, light/dark themes, the pixel unit
  base.css              Graph-paper page, buttons, inputs, utilities
  layout.css            Page layout; desktop two-column layout
  cat.css               The room, sprite states, idle animations, effects
  panels.css            Journal, tabs, memories, scrapbook, month, calendar, dialogs
  games.css             Games
src/
  main.js               Startup: opens the database and wires the modules together
  config.js             Supabase project URL + public anon key (empty = no cloud sync)
  cloud/
    sync.js             Sign-in with email + password, push/pull sync with Supabase (entries, photos, state, room)
    ai.js               Asks api/mimi.mjs to check a good thing or chat
    friends.js          Invite codes, the friends list, a friend's room
  core/                 Infrastructure, no UI
    db.js               IndexedDB database (localStorage fallback)
    store.js            In-memory data + persistence, change events, backup/restore
    dates.js            Local day keys and date formatting
    dom.js              Small DOM helpers
    pixel.js            Draws pixel art as SVG
    images.js           Shrinks photos before saving
    ics.js              Calendar files (daily reminder, sticky notes)
  cat/                  The cat itself
    sprite.js           Sprite data, fur palettes, accessories, SVG and canvas drawing
    mimi.js             Moods, reactions, idle habits, sleep schedule
    sound.js            Meow and purr playback
    music.js            Notes, jingles and sound effects for the games (Web Audio)
    fur-photo.js        Fur palette from a photo of your cat
  world/
    world.js            Unlock list, the pixel room, treasures
    surprises.js        Rare finds and dreams
    seasons.js          Halloween, Christmas, Lunar New Year, your anniversary
    room-snapshot.js    What friends see when they visit (only the room)
  memory/               How Mimi understands you (pure logic)
    insights.js         Keyword reactions, categories, learned facts, monthly recap
    quotes.js           Mimi's notes and how a new one is picked each visit
    relationship.js     Days together and milestones
    scrapbook.js        When pages are added and which entry is kept
    mimi-good.js        Mimi's own good thing of the day
    postcard.js         The weekly postcard's lines
    themes.js           Things you keep mentioning, and the objects they put in the room
    theories.js         Mimi's theories: connecting good things into conclusions
    wishes.js           Finding wishes in good things and noticing when they come true
    year-ago.js         Good things from this date in earlier years, and Mimi's remark
    about.js            Memory pages: everything about one person, place or thing
    remember.js         "Mimi remembers before you do": something that went quiet
    reminders.js        Sticky notes: reading "text Mom tomorrow at 6", due and repeating notes
    needs.js            Fish and water as gentle needs: when Mimi looks a little sad
    streak.js           Paw prints: this week, runs with naps, run milestones
  games/                The games in the Play sheet
    catch.js            Catch the fish (canvas)
    pairs.js            Pairs (memory cards)
    song.js             Mimi's song (repeat the tune)
    shuffle.js          Box shuffle (find Mimi's box)
    belly.js            Belly trap (pet where asked, not the belly)
    tower.js            Cushion tower (canvas stacker)
    toss.js             Treat toss (canvas slingshot)
  ui/                   One module per part of the page
    habitat.js          Room on screen, pixel sizing, petting
    topbar.js           Days together, sound toggle, settings icon
    intro.js            "What's your name?"
    note.js             Mimi's note under their name
    wardrobe.js         Dress up: wear items per slot
    photos.js           Photo album, viewer, and thumbnails used elsewhere
    diary.js            Private diary pages, mood weather, little Mimi on the page
    jar.js              Jar of good things: tap or shake to pull one out
    bedtime.js          Tuck Mimi in at night
    postcard.js         The postcard on the floor and its dialog
    about.js            Memory page sheet (room things, people, places)
    thanks.js           Thank-you cards
    journal.js          Writing good things, prompts, unlock, scrapbook, wish and room-thing events
    year-ago.js         The "one year ago today" card
    reminders.js        Sticky notes card, Mimi's "psst" at a note's time
    tabs.js             Accessible tabs
    memories.js         Memory cabinet
    scrapbook.js        Scrapbook pages
    month.js            Monthly recap
    calendar.js         Calendar and search
    play.js             Fish, water, cuddles, and laser play
    games.js            The Play sheet: picking a game, results, bests
    streak.js           This week's paw prints under the journal
    install.js          "Keep Mimi safe": Add to Home Screen, and asking to keep the app's data
    settings.js         Settings dialog, reminder file, backup
    account.js          Account & sync section in Settings
    friends.js          Friends section in Settings: invites, friends list
    visit.js            Visiting a friend's room
    theme.js            Day & night, match my phone, light, dark
    chat.js             Chat with Mimi
    share.js            Share picture

Conventions:

core and memory never touch the page; ui modules each own one part of the page and re-render when the store changes (store.on(render)).
Data changes go through the store: addEntry / removeEntry for good things; for everything else change store.<name> then call store.save("<name>").
New files must be added to SHELL in sw.js so they work offline.

Data

Mimi is local-first: the on-device database is what the app reads and writes, so it's instant and works offline. When you're signed in, it's mirrored to a Supabase (Postgres) database.

On this device: IndexedDB (`mimi-arigato`)

Store	Contents
`entries`	One record per good thing: `{ id, day, text, createdAt, updatedAt, deleted, synced, photoId, tags }`; `tags` is `{ people, places, things }` from the AI, or null
`kv`	`settings` (+ when each setting changed; includes `customFur` and `framePhoto`), `scrapbook`, `treasures`, `firstMet`, `milestones`, `surprises`, daily `pets`/`treats` (fish)/`water`/`cuddles` counters, `quietDay` ("Nothing special today"), `installLater`, `runSaid`, `chat` (Chat with Mimi, device only), `lastVisit`, sync bookmarks, and per-device bits: `mimiGood` (today's line), `tucked` (tonight), `postcardSeen`/`postcardAnnounced`, `seasonsGreeted`, `motionAsked`, `yearAgoGreeted`, `remembered`/`rememberedAt`; synced: `theories`, `wishes`, `roomThings`, `reminders`, `fed` (last day fed/watered), `quietDays`; per device: `stickyGreeted`, `stickySaid`, `gameBests`
`photos`	Photo details: `{ id, day, caption, entryId, createdAt, updatedAt, deleted, synced, uploaded, hasFull, hasThumb }`
`photoFiles`	The image files, keyed `<photo id>:full` and `<photo id>:thumb`

Data from earlier versions (plain localStorage) moves into the database automatically. If IndexedDB isn't available (some private-browsing modes), the app falls back to localStorage.

In the cloud: Supabase (Postgres)

Table	Contents
`entries`	`id, user_id, day, text, created_at, updated_at, deleted, synced_at, photo_id, tags (jsonb)`
`user_state`	`user_id, data (jsonb: settings, scrapbook, treasures, milestones, firstMet, theories, wishes, roomThings, reminders), updated_at`
`photos`	`id, user_id, day, caption, entry_id, created_at, updated_at, deleted, synced_at`
`friend_invites`	`code, user_id, created_at, expires_at, used_by`: one-use codes, 7 days
`friends`	`user_id, friend_id, created_at`: one row each way, made only by `accept_invite()`
`rooms`	`user_id, snapshot (jsonb: cat name, fur, wear, total, treasures, things, season), updated_at`: readable by friends
`ai_usage`	`user_id, day, checks, chats`: AI calls per day, counted by `mimi_ai_call()`
Storage bucket `photos`	Private image files at `<user id>/<photo id>.jpg` and `…-thumb.jpg`

Entries also have a photo_id column linking a good thing to its photo.

Row-level security means each person can only read and write their own rows. The one exception is rooms: your friends can read your room snapshot. peek_invite() and accept_invite() are the only way to use someone else's invite code.

How sync works

When: right after sign-in, on open, about 1.5 s after any change, when the device comes back online, and every 5 minutes.
Entries: changed entries are pushed; then everything other devices changed since the last pull is fetched, ordered by synced_at (stamped by the server, so wrong device clocks don't matter). If the same entry changed in two places, the newer edit wins.
Deletions are kept as tombstones (deleted = true) so every device learns about them.
Settings merge field by field (the most recent change to each setting wins); scrapbook, treasures, milestones, theories, wishes and room things are combined, so a new device never wipes your history. A wish that came true on either device stays true; for sticky notes the most recent change to each note wins.
Anything you wrote before signing in is uploaded to your account when you sign in.
Pet, fish, water and cuddle counters and the chat stay on each device; the days Mimi was fed and watered, and your "Nothing special today" days, sync.

Cloud sync setup (about 5 minutes)

Create a free project at supabase.com → New project.
Open SQL Editor → New query, paste the contents of supabase/schema.sql, and click Run.
Open Authentication → Sign In / Providers → Email: keep Email enabled, and turn Confirm email off if you want people signed in right after creating an account (no email needed). If you leave it on, also set Authentication → URL Configuration → Site URL to where Mimi runs (e.g. https://mimi-arigato.vercel.app) so the confirmation link comes back to Mimi.
Open Project Settings → API and copy the Project URL and the anon public key into src/config.js:
```
export const SUPABASE_URL = "https://YOUR-PROJECT.supabase.co";
export const SUPABASE_ANON_KEY = "eyJ...";
```
The anon key is meant to be public; row-level security protects the data. Never put the service_role key in the app.
Reload Mimi → Settings → Account & sync → Create an account with your email and a password.

Updating: when a new version adds tables (like photos), run supabase/schema.sql again. It's safe to re-run.

Checking that sync works:

In the app, the cloud button at the top shows Synced (green cloud), Syncing…, or Sync problem (hover or open it for the reason). Settings → Account & sync shows "Synced just now" and has Sync now.
In Supabase, open Table Editor → entries / photos / user_state to see the rows, and Storage → photos to see image files (one folder per person).
Try it across devices: write something on your phone, then tap Sync now on your laptop.

Notes:

Passwords need at least 6 characters (Supabase's default).
Sign-in links and codes: "Email me a sign-in link" uses Supabase's magic link email. On iPhone a link opens in Safari, not in the Home Screen app, so add the code to the email: Authentication → Emails → Magic Link, add a line like Or type this code in Mimi: {{ .Token }}. Also add your site to Authentication → URL Configuration → Redirect URLs so the link comes back to Mimi.
If Confirm email is on, Supabase's built-in email sender only sends a few emails per hour; set up your own SMTP under Authentication → Emails for real use.
The Supabase client library is loaded from a CDN only when cloud sync is configured, so offline use is unaffected.

Cat café setup (one time)

Re-run supabase/schema.sql (adds the café's Realtime policies). Realtime must be on for the project (it is by default). Cafés are private channels, so they work whether or not Realtime's "Allow public access" is on. If a café says "The café's door is stuck", the policies are probably missing: re-run the schema.

Notifications setup (one time)

Re-run supabase/schema.sql (adds push_subscriptions).
In Vercel → Project → Settings → Environment Variables, add VAPID_PUBLIC_KEY (the same value as in src/config.js), VAPID_PRIVATE_KEY, CRON_SECRET (any long random string), and SUPABASE_SERVICE_ROLE_KEY (Supabase → Project Settings → API → service_role; it stays on the server). Redeploy.
In GitHub → the repo → Settings → Secrets and variables → Actions, add CRON_SECRET with the same value as in Vercel.
Try it: GitHub → Actions → "Mimi's notes" → Run workflow. The run's log shows {"devices":…,"sent":…}. To make a new key pair: node -e 'const c=require("crypto");const k=c.generateKeyPairSync("ec",{namedCurve:"prime256v1"});const p=k.publicKey.export({format:"jwk"});console.log(Buffer.concat([Buffer.from([4]),Buffer.from(p.x,"base64url"),Buffer.from(p.y,"base64url")]).toString("base64url"),k.privateKey.export({format:"jwk"}).d)' (public, then private).

Not doing (on purpose)

Hunger or health bars (Mimi only looks a little sad on a day with empty bowls, and cheers up at once), punishment, "Mimi is sad you didn't visit", streaks that reset, losing accessories, coins, energy, ads, quests. Mimi says one thing: "Tell me one nice thing."

Next up

Direction (2026-10-07): make Mimi's memory the heart of the app: your life slowly becomes a little world. Built on 2026-10-07: AI tags (people, places, things), memory pages from room things and Memories, theories you can correct, and "Mimi remembers before you do". Ideas to grow them:

Tag older good things (a one-time "Mimi rereads your good things" for entries from before tags, within the daily AI limit).
Room objects from AI things, not only the 18 keyword themes (pottery, Taipei cafés…); a suitcase that lists your places.
A scrapbook-style page for a person after many mentions; thank-you cards from a person's page. Then: letters to future you, the Let-It-Go jar (never saved), diary weather showing in the room. Not now: a memory graph screen, personality modes, friendship tree; save stats and chapters for Mimi Wrapped.
Pick up here (2026-10-07): the AI check, earned fish/water/cuddles and Chat with Mimi are built (ec41a7d) but only tested with a fake Gemini. Before testing for real: push the 4 local commits, add GEMINI_API_KEY in Vercel, re-run supabase/schema.sql. Then check real Gemini replies and that Vercel runs api/mimi.mjs.
Built 2026-10-17: today's challenge (earns a treat bag; one treat per good thing now), the cat's photo diary, Pumpkin patch (Halloween), and notifications (daily nudge + sticky notes). Next seasonal games: one for Christmas (from Dec 18) and one for the Lunar New Year.
Hide a treasure (step 2 of the first multiplayer game; friends and visiting are done): hide one of your treasures in a spot in your room for a friend to find ("sniff sniff warmer!"); the finder keeps a copy tagged with where it came from. Then step 3, your cat visiting a friend's room for a day. Design: docs/superpowers/specs/2026-10-04-visiting-cats-hide-a-treasure-design.md. Later games on the same friends: paint together (a shared pixel canvas that hangs in both rooms), fishing together (live, co-op).
"Mimi Wrapped" in December: a year-in-review story you tap through (total good things, top people, favorite things, mood weather across the year, scrapbook highlights), built from Month, Memories and Scrapbook, with a share card at the end.

Ideas for later

Big ideas (logged 2026-10-17)

Mimi becomes your cat: the AI reads your cat's markings from the cat diary photos (tabby stripes, white chest, socks, a patch over one eye, ear color) and the pixel sprite gets matching marking layers, not just one fur color.
Mimi's dreams: after Tuck in, Mimi "dreams" a 3-panel pixel comic from your week's good things (people, foods, places), delivered as a morning notification and kept in a dream book.
Your life as a little town: a door in Mimi's room opens onto a pixel town that grows from your memories: places become buildings, people who come up often become residents, tap a building for its memory page.
Mimi goes on trips: now and then Mimi travels to a place from your wish jar, sends pixel postcards for a couple of days (empty cushion, "back soon" note), and comes home with a souvenir.
Today's song: a 20-second chiptune at bedtime composed from your day (mood sets tempo and key, each good thing is a phrase), collected into a year's playlist (cat/music.js).
More notes from Mimi: notifications for the Sunday postcard, "something from a year ago", a wish come true, a new theory (still at most one a day).
Letters to future you delivered by notification; a thank-you nudge ("Lin came up 5 times this month: send a card?"); gentler hard days (several hard days in a row bring back good things about your people); tell Mimi out loud (speech to text).
Private usage numbers: anonymous daily counts (came back, challenges finished, notifications tapped) to see what actually helps.

Diary extras

"Let it go": write a worry, give it to Mimi, she bats it away. Never saved.
Gentle prompts on a blank page ("What happened today?"), never required.
"A year ago today…" card on today's page.
Diary lock (passcode) for shared phones. Hides it on the device only; real end-to-end encryption is a bigger job.

Other ideas

Letters to future you, sealed until a date you pick.
Mood weather shown through Mimi's window (once the window is unlocked).
Mimi's room follows the real season and time of day (snow in winter, a lamp at night); more idle animations and room items.
Thank-you cards from past days (calendar and Memories), not only today's list.

To decide (from the 2026-10-04 build)

Should rainy/stormy diary weather affect the jar at all? Right now it makes the stars glimmer and Mimi sit by the jar more (she never reads the words). Alternative: the diary has no effect anywhere.
Your photo on the wall waits for the wall picture (75 good things). Alternative: hang it as soon as you add your first photo.
The ghost costume reads more like a white bib; redraw it before Halloween (Oct 18).
Fur from a photo uses the main color near the middle of the photo, so a busy background can pull the color off. Alternative: let you tap the cat in the photo to choose the color.
Monthly share card: a pixel image of the month's good things and weather.
Optional AI reactions for entries the keyword rules don't recognize.

To decide (from the theories / wishes build)

Capitalized place names count as people ("Kyoto") when signed out. Signed in, the AI tags fix it (once a place is tagged anywhere, it's not a person in older entries either).
Wishes match on keywords, so "I want to learn to make bread" can come true from "had bread". Mimi asks ("Did you just do it?!") rather than declares; a "not yet" button in Memories could undo it.
"Noticing change" ("you used to say you didn't like going places alone") needs AI to do well; theories cover the simpler "went quiet" and "liked for a long time".

Credits

Sounds: "Loud cat purring" (Freesound community) trimmed to 1.5 s, and a meow (yomecerlm3), trimmed to 0.9 s, both via Pixabay.

Read the full README ↗

README

Mimi Arigato

A tiny cat who remembers your life.

Notice → Tell Mimi → Mimi reacts → Mimi remembers → Mimi connects things → Mimi knows you

The five pillars

Pillar	What it does
Good things	Tell Mimi up to five good things a day. One is a good day; five is Mimi's favorite.
Mimi	A pixel cat with moods, reactions to what you write, idle habits, and a purr.
Memories	Mimi connects your good things into theories about you, remembers what happened a year ago, and keeps your wishes.
Little world	Mimi's room fills up with things as your good things add up, things from your own life, and treasures Mimi finds.
Scrapbook	Every so often Mimi keeps one of your good things as a scrapbook page.

What you can do

Meet Mimi

How Mimi works: a short guide opens by itself on your first visit, and any time from the ? button in the top bar.
A good thing to remember: every time you open the app (or come back to it after 30 minutes away), a pop-up brings back one of your past good things, with its photo and a line from Mimi. Something from this day in an earlier year comes first. Another one pulls a different one; Tell Mimi about today shows when you haven't told Mimi anything yet today.
A new note every visit: under Mimi's name there's a little note in their voice ("Small things count. Especially snacks."). About 60 notes are dealt in shuffled order with no repeats; some fit the time of day, and some are personal (your name, your favorite things, a past good thing, days together). Tap the note for another.
On your first visit Mimi says hello and asks "What's your name?" Mimi then greets you by name ("Good morning, Trang!", "you're back, Trang!"). Choose "Maybe later" to skip; you can add or change it in Settings.

Tell Mimi good things

Write up to five entries a day. Hearts fill as you go: "One is enough today" → "That's a good day" → "Mimi's favorite kind of day."
Mimi reacts to what you wrote, entirely on-device using keywords:
- coffee → "Mimi approves." · rain → "likes rainy windows too." · a friend or family → "thinks that sounds special."
- finished something → "is so proud of you." · someone was kind → "loves a little kindness."
- a hard day → "says that counts too." (Mimi never forces positivity)
- taxes → "doesn't understand taxes, but is proud of you."
If you write something you've written before, Mimi remembers: "remembers you wrote about this on Sep 28 too."
Mimi's good thing: after your first good thing of the day, Mimi shares one of their own ("my turn!": "A sunbeam moved onto the cushion."). It shows under the journal for the rest of the day. Lines only mention things Mimi actually has (room items, treasures, seasonal decorations).
Thank-you cards: when a good thing mentions someone (a name, or Mom, Dad, Grandma…), an envelope button appears next to it. It makes a 1080×1350 pixel card ("Thank you, Lin!") with your words, Mimi, and "with love from Trang & Mimi" to save or send. You can change who it's for.
One year ago today: on a date you wrote something in an earlier year, a small card at the top of the journal shows what you told Mimi then (with its photo), and Mimi says something about it: "You still like ramen. Some things are very reliable.", "Anna is still around. Mimi is glad.", or, if you made a wish that day that later came true, "…And then you did it." Mimi mentions it once when you open the app that day.
Wishes: when a good thing says "I want to…", "I'd love to…", "someday I'll…", "I wish I could…" or "my dream is to…", Mimi folds the wish into the jar ("folded your wish into the jar: “learn pottery.”"), and a little paper tag hangs on the jar. When a later good thing mentions the same thing ("Went to my first pottery class!"), Mimi says "remembers you wished to “learn pottery” on Oct 4, 2025. Did you just do it?!" Now and then the jar gives you a wish back instead of a star ("Still keeping it safe for you."). Removing the good thing that made a wish removes the wish.
Stuck? Tap "Stuck? Pick something to think about" for prompts: something tiny, someone who was kind, something that made you laugh, something delicious, something you're proud of, something cute, something beautiful, something worth remembering.

Days together and paw prints

The top bar shows "Day 37 together": how long you've known Mimi, which never resets.
Paw prints: a row of this week's days (Monday first) under "Tell Mimi something good". A day gets a paw print when you tell Mimi a good thing (or tap "Nothing special today"). Missed days show as naps ("z"), never as gaps. Under it: "4 paw prints this week · a 9-day run · longest 12". A run keeps going through up to 2 naps a week, so it only ends after a really quiet week, and nothing says it broke. Mimi cheers runs of 3, 7, 14, 30, 50, 100, 200 and 365 days once. Worked out from your good things (plus synced "Nothing special" days), so it follows you to new devices.
Milestones are celebrated once: Day 1 "nice to meet you", Day 7 "recognizes you now", Day 30 "knows some of your favorite things", Day 100, one year; and 50 / 100 / 250 / 500 / 1,000 good things.
After a few days away: "you're back! Mimi kept your room cozy while you were away."

Sticky notes (reminders)

A Sticky notes card under the journal: tell Mimi what you don't want to forget, in your own words. "text Mom tomorrow at 6", "pay bills on Friday", "pay rent on the 1st every month", "water the plants every Sunday", "dentist Oct 12 at 9:30am", "take out trash tonight", "call grandma in 3 days".
As you type, Mimi fills in the day, time and repeat (once, every day/week/month/year), and you can change them before tapping Give to Mimi. With no day the note is for today; "at 6" means 6 pm.
Mimi holds them: when you open the app with notes due, Mimi says "psst… is holding a note for you: “Text Mom.”", and a little yellow sticky note appears on the room's wall (tap it to jump to the notes). If the app is open at a note's time, Mimi taps your hand.
On each note: ✓ (Mimi: "hopes Mom says hi back.", "doesn't understand money, but is proud of you."), later (moves it to tomorrow), add to calendar (a calendar event with an alert, repeating if the note repeats), and ×. A repeating note moves on to its next day when checked.
Mimi never scolds: a note from an earlier day just says "from Oct 2". Coming up lists the next few notes.
With notifications turned on (Settings → Daily reminder), Mimi sends a note in the hour it's due: "Xiao Mi is holding a note for you: Text Mom". Otherwise the alert comes from your calendar app ("add to calendar"). Notes sync and are in backups.

Mimi, the cat

Tap Mimi to pet them: a meow or purr (real recordings), happy ^ ^ eyes, blush, tail wags, a floating heart, and a little line ("leans into your hand."). Sometimes Mimi recalls one of your past entries.
Sound on/off: speaker button at the top right (remembered). On iPhone, the ring/silent switch also mutes web sounds.
Idle habits: every so often Mimi grooms a paw, yawns, dozes, stretches, chases their tail, stares at you, looks out the window, watches the aquarium fish, admires their accessory, or sits by the journal "waiting to hear about your day."
Time of day: asleep 10 pm to 6 am ("z z z"; tap to wake). Morning stretch, lunchtime thoughts, evening "ready to hear about your day."
Fish, water, cuddles: each good thing you tell Mimi today earns one treat, in turn: a fish, then water, then a cuddle, then a fish again (up to 5 good things). Give them whenever you like (a fish drops in, a water drop, a purring snuggle). Filling both bowls takes two good things, or one and today's challenge.
Today's challenge: a card under the journal with one small thing to go and do, the same on every device: "Take photos of 3 different cats", "Take a selfie with Xiao Mi", "Find 3 pink things", "Look up! Take a photo of the sky", "Tell Mimi 3 good things today" (18 in all, picked by date). For photo challenges, tap Add a photo: when you're signed in, Mimi's AI looks at it ("ooh, a fluffy orange cat!" or "hmm, that looks like a loaf of bread to me."), and only a photo that shows the right thing fills a slot. Signed out or offline, Mimi trusts you. The same photo can't count twice. Photos that count are kept in Photos, captioned with the challenge. Finishing it earns a treat bag: one more fish, water and cuddle.
Food and water bowls: two little bowls on the floor of Mimi's room, full once you've given a fish or water today. From 9 am (or from the moment Mimi wakes up, if that bowl stayed empty all of yesterday), if a bowl is still empty, Mimi looks a little sad (droopy eyes, a tiny tear, a frown, a slow tail) and says "is sitting by their empty bowls…" (or, when you open the app after forgetting yesterday, "missed you yesterday. The bowls stayed empty."); the tray says the bowls are empty and how to earn a treat. The first fish or drink gets a big "yay!! was so hungry. Thank you! ♡". Never on your first day, never at night, and never worse than a little sad. "Nothing special today" always earns a fish, so there's always a way. Feeding syncs, so feeding on your phone fills the bowls on your laptop too.

Mimi's little world

Everything unlocks by total good things and never goes away:

Good things	Unlocks
5	Little flower (to wear)
15	Ribbon bow (to wear)
30	Tiny plant
40	Cozy scarf (to wear)
50	Cushion
75	Wall picture
100	Window (the sky outside follows the time of day)
120	Beret (to wear)
150	Bookshelf
200	Tiny crown (to wear)
250	Aquarium
500	Starry window

The journal shows what's next: "Next for Mimi's world: a cushion at 50 good things."
Things from your life: when something comes up in three good things, a small object for it appears in the room and Mimi says "has been noticing a theme. A coffee mug appeared in the room." There are 18: coffee mug, teapot, stack of books, radio, toy mouse (cats), dog bone, umbrella (rain), vase of flowers, little pot (cooking), noodle bowl, cupcake (sweets), suitcase (travel), beach ball (the sea), sneakers (walks and runs), camera (photos), game controller, paint palette (art), popcorn (movies). Four sit on the floor and two on a little wall shelf; with more than six, the most-mentioned ones show. Tap one for a line ("sniffs your coffee mug. Still warm."). They never go away.
Jar of good things: a jar on a shelf under the window fills with paper stars (one per 5 good things, up to 16). Tap it, or shake your phone, and Mimi pulls out a random past good thing and reads it to you. On iPhone, shaking asks for motion permission the first time you tap the jar. On days your diary weather is rainy or stormy, the stars glimmer and Mimi likes to sit by the jar. That's the only thing Mimi takes from the diary: the weather, never the words.
Your photo on the wall: once the wall picture is unlocked (75), it shows one of your photos, pixelated to match the room. It's your newest photo unless you choose one with Hang in Mimi's room in the photo viewer.
Weekly postcard: on Sundays Mimi leaves a postcard on the floor about the week (Monday to Sunday): how many good things, how often you laughed, who came up, what kept showing up, and Mimi's favorite of the week. It stays until the next one (Monday to Saturday you see last week's), sparkles until read, and Mimi says "mail!" once when it arrives.

Seasons: for a few days a year the room gets a decoration and the wardrobe gets costumes, then they go away until next year:

When	Room	Wardrobe
Halloween (Oct 18 to Nov 1)	pumpkin and a bat	witch hat, ghost costume
Christmas (Dec 18 to 26)	wreath	Santa hat
Lunar New Year (3 days before to 7 days after)	red lantern	lucky knot
The day you met Mimi, every year after the first	cake with a candle

Mimi mentions it once per event each year. Costumes come off automatically when the event ends.

Photos

Photos tab: add photos of you and your cat ("Add photos", several at once). Tap one to see it large, write a caption, or delete it.
Mimi looks at your photos: when you're signed in, every photo you share (in Photos, or attached to a good thing) gets a look from Mimi's AI, and Mimi says something about it: "ooh, is that ramen? can i have some." The line stays under the photo in the photo viewer and syncs. Older photos, or ones added offline, have an Ask Mimi about this photo button. When you add many photos at once, Mimi looks at the first 5.
Attach a photo to a good thing: tap the camera button next to the journal box; the photo shows beside that entry, in the calendar, on its scrapbook page, and as the monthly favorite.
Photos are shrunk on the device before saving (longest side 1600 px, plus a small thumbnail) and turned upright automatically.
When signed in, photos sync to a private Supabase Storage bucket; other devices download thumbnails right away and full images when opened.

Mimi's things (tabs)

Your cat's diary (the tab is named after your cat, like "Xiao Mi's diary"): a photo a day of your real cat, or of the two of you (pick Xiao Mi or Xiao Mi & me before adding it). The cat writes a line about it in their own voice: "Sat in the sunbeam. Refused to move. 10/10." When you're signed in, Mimi's AI looks at the photo and writes it; otherwise it's one of a few built-in lines. Change the words or Change the photo any time. Flip back with ‹ ›, or tap a page in the strip underneath. Pages sync, and the photos are in Photos too. (Your own private diary is now called My diary.)
Cat translator (the button at the top of your cat's diary): add a photo of your real cat, and Mimi's AI reads their body language ("slow blink, ears relaxed, tail curled around paws") and says what they mean, in a speech bubble over the photo: "I love you. Also, dinner was 4 minutes ago." plus a mood (loving, playful, sleepy, grumpy…). Each translation goes into your cat's phrasebook (synced) and the photo into Photos. A photo with no cat gets a remark but isn't kept. Needs you to be signed in.
Memories: Mimi's theories first: every few days (at most one every 3 days, after 10 good things) Mimi connects some of your good things into a numbered theory, mentions it when you open the app, and keeps it forever. Mimi looks for:
- people who are around when good things happen ("Good things happen suspiciously often when Anna is around."), who make you laugh, and what's better with whom ("Coffee is better with Lin, apparently."), plus family who keep showing up
- things that go together ("Coffee on a rainy day might be your favorite thing in the world. Just a theory.")
- things you've liked for a long time, and things that went quiet ("You used to talk about cooking a lot. Not since March. Mimi is just noticing. No pressure.")
- what kind of person you are, according to a cat ("A suspicious amount of your happiness is edible.", "You find good things even on hard days.")
- when good things happen (a weekday, mornings or late nights)
Theories never use percentages or scores, and never use the diary. Each one has You're onto something (it gets a ✓) and Nope (Mimi "has made an error. They quietly take it off the evidence board."; it's gone for good and never suggested again). Then What Mimi has learned ("Mimi thinks you really like coffee." "You talked about Lin 3 times. Mimi knows Lin must be important." "Your mom came up 4 times. That sounds special.") plus a of drawers Mimi sorts on their own: People, Food, Things you were proud of, Things that made you laugh, Beautiful moments, Kindness, Rest, Moving your body, Hard days you got through, Little things, Wishes in the jar, Wishes that came true, and Treasures Mimi found.

Settings

Your name, the cat's name, fur color (Strawberry, Peach, Cloud, Midnight, Snow).
Appearance: Day & night (default: light from 6 am, dark from 7 pm, like the sky in Mimi's window), Match my phone, Light or Dark. Follows you to your other devices.
Account & sync (also the Sign in / cloud button at the top): create an account with your email and a password (or sign in to an existing one), or tap Forgot your password? Email me a sign-in link to sign in with no password (a link, plus a code to type, which is what works in the Home Screen app on iPhone). Your good things sync to the cloud and to every device you sign in on. "Sync now" shows when it last synced. Signing out asks whether to keep a copy on this device or remove it (for shared devices).
Daily reminder: adds a repeating event to your calendar app. Or tap Turn on notifications (signed in; on iPhone, from the Home Screen app, iOS 16.4 or later): at your reminder time, on a day you haven't told Mimi anything yet, Mimi sends one gentle note ("Xiao Mi is sitting by their empty bowls… one good thing earns a fish."), never more than one a day. Sticky notes with a time arrive in their hour too. It's per device, follows the device's time zone, and is sent by api/nudge.mjs, which a GitHub Actions schedule (.github/workflows/nudge.yml) calls every hour.
Friends (when signed in): "Invite a friend" makes a code like ABC-234 and a link to share; a friend opens the link or types the code under "Have a code?" and says yes. Tap a friend to visit their room: their cat, unlocks, treasures, seasonal decor and things from their life. Never their good things, diary or photos. "Show my things to friends" hides your things from your life from visitors. Either of you can remove the friendship.
The cat café (when signed in): the Café button lists your café and each friend's, with how many cats are there right now. Inside, every cat present sits on a cushion. Tap someone's cat to pet them (hearts for everyone; "Bun pet Xiao Mi! ♡"), and chat: messages float above your cat and fill a little log. Everyone hosts a café, and only the host and the host's friends can come in, so you may meet a friend's other friends there. Live only: nothing is saved, and messages are gone when you leave. Built on private Supabase Realtime channels (cafe:<host id>), allowed by mimi_can_enter_cafe in supabase/schema.sql.
Chat with Mimi (when signed in): the Chat button opens a little conversation with your cat. Mimi knows your names, your recent good things and wishes (never your diary). The chat stays on this device.

Running it

No build step and no dependencies. Serve the folder with any static server:

python3 -m http.server 5173
# open http://localhost:5173

Project structure

index.html              Page markup (the room, journal, tabs, dialogs)
manifest.webmanifest    Install-to-home-screen metadata
sw.js                   Offline support (network first, cached copy when offline)
supabase/schema.sql     Cloud database tables and security rules (run once in Supabase)
api/mimi.mjs            Vercel function: Mimi's AI (good-thing check + chat, Gemini), 120 calls/person/day
assets/
  icon.svg              App icon (vector)
  icons/                PNG app icons (home screen, maskable, Apple touch, favicon)
  sounds/meow.m4a       0.9 s meow clip
  sounds/purr.m4a       1.5 s purr clip
styles/
  tokens.css            Colors, fonts, light/dark themes, the pixel unit
  base.css              Graph-paper page, buttons, inputs, utilities
  layout.css            Page layout; desktop two-column layout
  cat.css               The room, sprite states, idle animations, effects
  panels.css            Journal, tabs, memories, scrapbook, month, calendar, dialogs
  games.css             Games
src/
  main.js               Startup: opens the database and wires the modules together
  config.js             Supabase project URL + public anon key (empty = no cloud sync)
  cloud/
    sync.js             Sign-in with email + password, push/pull sync with Supabase (entries, photos, state, room)
    ai.js               Asks api/mimi.mjs to check a good thing or chat
    friends.js          Invite codes, the friends list, a friend's room
  core/                 Infrastructure, no UI
    db.js               IndexedDB database (localStorage fallback)
    store.js            In-memory data + persistence, change events, backup/restore
    dates.js            Local day keys and date formatting
    dom.js              Small DOM helpers
    pixel.js            Draws pixel art as SVG
    images.js           Shrinks photos before saving
    ics.js              Calendar files (daily reminder, sticky notes)
  cat/                  The cat itself
    sprite.js           Sprite data, fur palettes, accessories, SVG and canvas drawing
    mimi.js             Moods, reactions, idle habits, sleep schedule
    sound.js            Meow and purr playback
    music.js            Notes, jingles and sound effects for the games (Web Audio)
    fur-photo.js        Fur palette from a photo of your cat
  world/
    world.js            Unlock list, the pixel room, treasures
    surprises.js        Rare finds and dreams
    seasons.js          Halloween, Christmas, Lunar New Year, your anniversary
    room-snapshot.js    What friends see when they visit (only the room)
  memory/               How Mimi understands you (pure logic)
    insights.js         Keyword reactions, categories, learned facts, monthly recap
    quotes.js           Mimi's notes and how a new one is picked each visit
    relationship.js     Days together and milestones
    scrapbook.js        When pages are added and which entry is kept
    mimi-good.js        Mimi's own good thing of the day
    postcard.js         The weekly postcard's lines
    themes.js           Things you keep mentioning, and the objects they put in the room
    theories.js         Mimi's theories: connecting good things into conclusions
    wishes.js           Finding wishes in good things and noticing when they come true
    year-ago.js         Good things from this date in earlier years, and Mimi's remark
    about.js            Memory pages: everything about one person, place or thing
    remember.js         "Mimi remembers before you do": something that went quiet
    reminders.js        Sticky notes: reading "text Mom tomorrow at 6", due and repeating notes
    needs.js            Fish and water as gentle needs: when Mimi looks a little sad
    streak.js           Paw prints: this week, runs with naps, run milestones
  games/                The games in the Play sheet
    catch.js            Catch the fish (canvas)
    pairs.js            Pairs (memory cards)
    song.js             Mimi's song (repeat the tune)
    shuffle.js          Box shuffle (find Mimi's box)
    belly.js            Belly trap (pet where asked, not the belly)
    tower.js            Cushion tower (canvas stacker)
    toss.js             Treat toss (canvas slingshot)
  ui/                   One module per part of the page
    habitat.js          Room on screen, pixel sizing, petting
    topbar.js           Days together, sound toggle, settings icon
    intro.js            "What's your name?"
    note.js             Mimi's note under their name
    wardrobe.js         Dress up: wear items per slot
    photos.js           Photo album, viewer, and thumbnails used elsewhere
    diary.js            Private diary pages, mood weather, little Mimi on the page
    jar.js              Jar of good things: tap or shake to pull one out
    bedtime.js          Tuck Mimi in at night
    postcard.js         The postcard on the floor and its dialog
    about.js            Memory page sheet (room things, people, places)
    thanks.js           Thank-you cards
    journal.js          Writing good things, prompts, unlock, scrapbook, wish and room-thing events
    year-ago.js         The "one year ago today" card
    reminders.js        Sticky notes card, Mimi's "psst" at a note's time
    tabs.js             Accessible tabs
    memories.js         Memory cabinet
    scrapbook.js        Scrapbook pages
    month.js            Monthly recap
    calendar.js         Calendar and search
    play.js             Fish, water, cuddles, and laser play
    games.js            The Play sheet: picking a game, results, bests
    streak.js           This week's paw prints under the journal
    install.js          "Keep Mimi safe": Add to Home Screen, and asking to keep the app's data
    settings.js         Settings dialog, reminder file, backup
    account.js          Account & sync section in Settings
    friends.js          Friends section in Settings: invites, friends list
    visit.js            Visiting a friend's room
    theme.js            Day & night, match my phone, light, dark
    chat.js             Chat with Mimi
    share.js            Share picture

Conventions:

core and memory never touch the page; ui modules each own one part of the page and re-render when the store changes (store.on(render)).
Data changes go through the store: addEntry / removeEntry for good things; for everything else change store.<name> then call store.save("<name>").
New files must be added to SHELL in sw.js so they work offline.

Data

Mimi is local-first: the on-device database is what the app reads and writes, so it's instant and works offline. When you're signed in, it's mirrored to a Supabase (Postgres) database.

On this device: IndexedDB (`mimi-arigato`)

Store	Contents
`entries`	One record per good thing: `{ id, day, text, createdAt, updatedAt, deleted, synced, photoId, tags }`; `tags` is `{ people, places, things }` from the AI, or null
`kv`	`settings` (+ when each setting changed; includes `customFur` and `framePhoto`), `scrapbook`, `treasures`, `firstMet`, `milestones`, `surprises`, daily `pets`/`treats` (fish)/`water`/`cuddles` counters, `quietDay` ("Nothing special today"), `installLater`, `runSaid`, `chat` (Chat with Mimi, device only), `lastVisit`, sync bookmarks, and per-device bits: `mimiGood` (today's line), `tucked` (tonight), `postcardSeen`/`postcardAnnounced`, `seasonsGreeted`, `motionAsked`, `yearAgoGreeted`, `remembered`/`rememberedAt`; synced: `theories`, `wishes`, `roomThings`, `reminders`, `fed` (last day fed/watered), `quietDays`; per device: `stickyGreeted`, `stickySaid`, `gameBests`
`photos`	Photo details: `{ id, day, caption, entryId, createdAt, updatedAt, deleted, synced, uploaded, hasFull, hasThumb }`
`photoFiles`	The image files, keyed `<photo id>:full` and `<photo id>:thumb`

Data from earlier versions (plain localStorage) moves into the database automatically. If IndexedDB isn't available (some private-browsing modes), the app falls back to localStorage.

In the cloud: Supabase (Postgres)

Table	Contents
`entries`	`id, user_id, day, text, created_at, updated_at, deleted, synced_at, photo_id, tags (jsonb)`
`user_state`	`user_id, data (jsonb: settings, scrapbook, treasures, milestones, firstMet, theories, wishes, roomThings, reminders), updated_at`
`photos`	`id, user_id, day, caption, entry_id, created_at, updated_at, deleted, synced_at`
`friend_invites`	`code, user_id, created_at, expires_at, used_by`: one-use codes, 7 days
`friends`	`user_id, friend_id, created_at`: one row each way, made only by `accept_invite()`
`rooms`	`user_id, snapshot (jsonb: cat name, fur, wear, total, treasures, things, season), updated_at`: readable by friends
`ai_usage`	`user_id, day, checks, chats`: AI calls per day, counted by `mimi_ai_call()`
Storage bucket `photos`	Private image files at `<user id>/<photo id>.jpg` and `…-thumb.jpg`

Entries also have a photo_id column linking a good thing to its photo.

How sync works

When: right after sign-in, on open, about 1.5 s after any change, when the device comes back online, and every 5 minutes.
Entries: changed entries are pushed; then everything other devices changed since the last pull is fetched, ordered by synced_at (stamped by the server, so wrong device clocks don't matter). If the same entry changed in two places, the newer edit wins.
Deletions are kept as tombstones (deleted = true) so every device learns about them.
Settings merge field by field (the most recent change to each setting wins); scrapbook, treasures, milestones, theories, wishes and room things are combined, so a new device never wipes your history. A wish that came true on either device stays true; for sticky notes the most recent change to each note wins.
Anything you wrote before signing in is uploaded to your account when you sign in.
Pet, fish, water and cuddle counters and the chat stay on each device; the days Mimi was fed and watered, and your "Nothing special today" days, sync.

Cloud sync setup (about 5 minutes)

Create a free project at supabase.com → New project.
Open SQL Editor → New query, paste the contents of supabase/schema.sql, and click Run.
Open Authentication → Sign In / Providers → Email: keep Email enabled, and turn Confirm email off if you want people signed in right after creating an account (no email needed). If you leave it on, also set Authentication → URL Configuration → Site URL to where Mimi runs (e.g. https://mimi-arigato.vercel.app) so the confirmation link comes back to Mimi.
Open Project Settings → API and copy the Project URL and the anon public key into src/config.js:
```
export const SUPABASE_URL = "https://YOUR-PROJECT.supabase.co";
export const SUPABASE_ANON_KEY = "eyJ...";
```
The anon key is meant to be public; row-level security protects the data. Never put the service_role key in the app.
Reload Mimi → Settings → Account & sync → Create an account with your email and a password.

Updating: when a new version adds tables (like photos), run supabase/schema.sql again. It's safe to re-run.

Checking that sync works:

In the app, the cloud button at the top shows Synced (green cloud), Syncing…, or Sync problem (hover or open it for the reason). Settings → Account & sync shows "Synced just now" and has Sync now.
In Supabase, open Table Editor → entries / photos / user_state to see the rows, and Storage → photos to see image files (one folder per person).
Try it across devices: write something on your phone, then tap Sync now on your laptop.

Notes:

Passwords need at least 6 characters (Supabase's default).
Sign-in links and codes: "Email me a sign-in link" uses Supabase's magic link email. On iPhone a link opens in Safari, not in the Home Screen app, so add the code to the email: Authentication → Emails → Magic Link, add a line like Or type this code in Mimi: {{ .Token }}. Also add your site to Authentication → URL Configuration → Redirect URLs so the link comes back to Mimi.
If Confirm email is on, Supabase's built-in email sender only sends a few emails per hour; set up your own SMTP under Authentication → Emails for real use.
The Supabase client library is loaded from a CDN only when cloud sync is configured, so offline use is unaffected.

Cat café setup (one time)

Notifications setup (one time)

Re-run supabase/schema.sql (adds push_subscriptions).
In Vercel → Project → Settings → Environment Variables, add VAPID_PUBLIC_KEY (the same value as in src/config.js), VAPID_PRIVATE_KEY, CRON_SECRET (any long random string), and SUPABASE_SERVICE_ROLE_KEY (Supabase → Project Settings → API → service_role; it stays on the server). Redeploy.
In GitHub → the repo → Settings → Secrets and variables → Actions, add CRON_SECRET with the same value as in Vercel.
Try it: GitHub → Actions → "Mimi's notes" → Run workflow. The run's log shows {"devices":…,"sent":…}. To make a new key pair: node -e 'const c=require("crypto");const k=c.generateKeyPairSync("ec",{namedCurve:"prime256v1"});const p=k.publicKey.export({format:"jwk"});console.log(Buffer.concat([Buffer.from([4]),Buffer.from(p.x,"base64url"),Buffer.from(p.y,"base64url")]).toString("base64url"),k.privateKey.export({format:"jwk"}).d)' (public, then private).

Not doing (on purpose)

Next up

Tag older good things (a one-time "Mimi rereads your good things" for entries from before tags, within the daily AI limit).
Room objects from AI things, not only the 18 keyword themes (pottery, Taipei cafés…); a suitcase that lists your places.
A scrapbook-style page for a person after many mentions; thank-you cards from a person's page. Then: letters to future you, the Let-It-Go jar (never saved), diary weather showing in the room. Not now: a memory graph screen, personality modes, friendship tree; save stats and chapters for Mimi Wrapped.
Pick up here (2026-10-07): the AI check, earned fish/water/cuddles and Chat with Mimi are built (ec41a7d) but only tested with a fake Gemini. Before testing for real: push the 4 local commits, add GEMINI_API_KEY in Vercel, re-run supabase/schema.sql. Then check real Gemini replies and that Vercel runs api/mimi.mjs.
Built 2026-10-17: today's challenge (earns a treat bag; one treat per good thing now), the cat's photo diary, Pumpkin patch (Halloween), and notifications (daily nudge + sticky notes). Next seasonal games: one for Christmas (from Dec 18) and one for the Lunar New Year.
Hide a treasure (step 2 of the first multiplayer game; friends and visiting are done): hide one of your treasures in a spot in your room for a friend to find ("sniff sniff warmer!"); the finder keeps a copy tagged with where it came from. Then step 3, your cat visiting a friend's room for a day. Design: docs/superpowers/specs/2026-10-04-visiting-cats-hide-a-treasure-design.md. Later games on the same friends: paint together (a shared pixel canvas that hangs in both rooms), fishing together (live, co-op).
"Mimi Wrapped" in December: a year-in-review story you tap through (total good things, top people, favorite things, mood weather across the year, scrapbook highlights), built from Month, Memories and Scrapbook, with a share card at the end.

Ideas for later

Big ideas (logged 2026-10-17)

Mimi becomes your cat: the AI reads your cat's markings from the cat diary photos (tabby stripes, white chest, socks, a patch over one eye, ear color) and the pixel sprite gets matching marking layers, not just one fur color.
Mimi's dreams: after Tuck in, Mimi "dreams" a 3-panel pixel comic from your week's good things (people, foods, places), delivered as a morning notification and kept in a dream book.
Your life as a little town: a door in Mimi's room opens onto a pixel town that grows from your memories: places become buildings, people who come up often become residents, tap a building for its memory page.
Mimi goes on trips: now and then Mimi travels to a place from your wish jar, sends pixel postcards for a couple of days (empty cushion, "back soon" note), and comes home with a souvenir.
Today's song: a 20-second chiptune at bedtime composed from your day (mood sets tempo and key, each good thing is a phrase), collected into a year's playlist (cat/music.js).
More notes from Mimi: notifications for the Sunday postcard, "something from a year ago", a wish come true, a new theory (still at most one a day).
Letters to future you delivered by notification; a thank-you nudge ("Lin came up 5 times this month: send a card?"); gentler hard days (several hard days in a row bring back good things about your people); tell Mimi out loud (speech to text).
Private usage numbers: anonymous daily counts (came back, challenges finished, notifications tapped) to see what actually helps.

Diary extras

"Let it go": write a worry, give it to Mimi, she bats it away. Never saved.
Gentle prompts on a blank page ("What happened today?"), never required.
"A year ago today…" card on today's page.
Diary lock (passcode) for shared phones. Hides it on the device only; real end-to-end encryption is a bigger job.

Other ideas

Letters to future you, sealed until a date you pick.
Mood weather shown through Mimi's window (once the window is unlocked).
Mimi's room follows the real season and time of day (snow in winter, a lamp at night); more idle animations and room items.
Thank-you cards from past days (calendar and Memories), not only today's list.

To decide (from the 2026-10-04 build)

Should rainy/stormy diary weather affect the jar at all? Right now it makes the stars glimmer and Mimi sit by the jar more (she never reads the words). Alternative: the diary has no effect anywhere.
Your photo on the wall waits for the wall picture (75 good things). Alternative: hang it as soon as you add your first photo.
The ghost costume reads more like a white bib; redraw it before Halloween (Oct 18).
Fur from a photo uses the main color near the middle of the photo, so a busy background can pull the color off. Alternative: let you tap the cat in the photo to choose the color.
Monthly share card: a pixel image of the month's good things and weather.
Optional AI reactions for entries the keyword rules don't recognize.

To decide (from the theories / wishes build)

Capitalized place names count as people ("Kyoto") when signed out. Signed in, the AI tags fix it (once a place is tagged anywhere, it's not a person in older entries either).
Wishes match on keywords, so "I want to learn to make bread" can come true from "had bread". Mimi asks ("Did you just do it?!") rather than declares; a "not yet" button in Memories could undo it.
"Noticing change" ("you used to say you didn't like going places alone") needs AI to do well; theories cover the simpler "went quiet" and "liked for a long time".

Credits

Sounds: "Loud cat purring" (Freesound community) trimmed to 1.5 s, and a meow (yomecerlm3), trimmed to 0.9 s, both via Pixabay.

Read the full README ↗

Play: opens a little arcade (your best score in each is kept on this device; games never earn or cost treats):

Laser dot: 20 seconds in the room; Mimi pounces when it lands on them. Steer it with your finger or mouse, or let it wander.
Catch the fish: 30 seconds of things falling from the sky; move Mimi under them (finger, mouse or arrow keys). Mimi opens their mouth when a fish is coming and chomps with happy ^ ^ eyes. Fish are +1, gold fish +3, and every 5 in a row is +2 more. A heart gives zoomies (fast, wider catch, afterimages, 5 s). Not everything is food: a cucumber spooks Mimi ("EEK!", they jump and freeze), rain soaks them (eyes shut, slow and shaky), and a sock gets spat back out ("blep"). They never take fish away; they just cost time and the streak, and the result says so ("caught 14 fish (and got spooked by 2 cucumbers and tried to eat a sock)!").
Pairs: twelve cards, six pairs of Mimi's favorite things (fish, heart, yarn, toy mouse, star, leaf). No timer, it only counts tries.
Mimi's song: Mimi plays a tune on four colored paws, one note longer each round, and you play it back. A wrong note ends it gently ("lost the tune too. Again?").
Box shuffle: Mimi peeks out of one of three boxes, ducks in, and the boxes shuffle. Tap Mimi's box. Each round adds a swap and goes faster; a wrong box ends it and Mimi pops out of the right one.
Belly trap: Mimi lies down and asks for pets ("Chin, please!", head, cheeks). Pet the right spot before their patience runs out. Sometimes Mimi shows their belly: rub it and all four paws grab your hand ("TRAP!"). 3 hearts; a trap or running out of patience costs one, and resisting the belly is a bonus.
Cushion tower: a cushion slides back and forth; tap (or Space) to drop it on the stack. Overhang is trimmed off, perfect drops snap into place, and Mimi hops up to the top each time. A total miss ends it.
Treat toss: pull back and let go like a slingshot (with a dotted aim line) to land a treat in Mimi's mouth; arrows and Space on a keyboard. 10 treats. A breeze starts on the third, and from the sixth Mimi sways sleepily. Miss and it bonks off their head.
Seasonal games show up only during their season, at the top of the list. Pumpkin patch (Halloween, Oct 18 to Nov 1): things pop out of nine pumpkins for a moment. Tap candy (+1), gold candy (+3) and bats (+2); a ghost is a "BOO!" and costs one of 3 hearts. 30 seconds, and things pop faster as time runs out.

Mimi Arigato

Languages

Updates0 updates

Comments

Trending in Health

Mimi Arigato

Languages

Updates0 updates

Comments

Trending in Health

Do you operate this project?

Introduction

README

Mimi Arigato

The five pillars

What you can do

Meet Mimi

Tell Mimi good things

Days together and paw prints

Sticky notes (reminders)

Mimi, the cat

Mimi's little world

Photos

Mimi's things (tabs)

Settings

Running it

Project structure

Data

On this device: IndexedDB (mimi-arigato)

In the cloud: Supabase (Postgres)

How sync works

Cloud sync setup (about 5 minutes)

Cat café setup (one time)

Notifications setup (one time)

Not doing (on purpose)

Next up

Ideas for later

Credits

README

README

Mimi Arigato

The five pillars

What you can do

Meet Mimi

Tell Mimi good things

Days together and paw prints

Sticky notes (reminders)

Mimi, the cat

Mimi's little world

Photos

Mimi's things (tabs)

Settings

Running it

Project structure

Data

On this device: IndexedDB (mimi-arigato)

In the cloud: Supabase (Postgres)

How sync works

Cloud sync setup (about 5 minutes)

Cat café setup (one time)

Notifications setup (one time)

Not doing (on purpose)

Next up

Ideas for later

Credits

On this device: IndexedDB (`mimi-arigato`)

On this device: IndexedDB (`mimi-arigato`)