Feed-The-Bear

for foodies

Save the spots you love, remember what to order, and decide where to eat fast. Live at https://www.feed-the-bear.com.

Run it locally

It's a static site with serverless functions in api/ (Vercel).

python -m http.server 8765      # from the repo root

Then open http://127.0.0.1:8765/app.html.

Photos, videos, sharing and account privacy

• Home leads with Add and the existing meal/decision actions, followed by recommendations and nearby discovery. Bear Swipe remains available below the personal recommendations rather than pushing meal logging off-screen.

• Video upgrade dialogs appear above the unfinished Add form; dismissal keeps the place and attachments. Capture forms explain Grizzly, 15-second and device-local clip limits before recording.

• Cloud-trimmed photos carry a content reference so recovery survives media reordering/removal and never assigns a poster to another clip. Ambiguous older extra-photo slots show a warning instead of guessing. Login copy explains backup limits rather than guaranteeing all photos follow you to a new phone.

• Sharing a photo-free place on a browser without a share sheet reveals its editable caption and manual social-posting guidance. Blocked sharing reports a usable fallback; cancelling the share sheet is not an error.

• Same-device cloud restores recover budget-trimmed extra place photos as well as visit/dish photos. Restored video posters must match the stored clip reference; removed media entries are not recreated.

• Quick detail ratings, prices and status edits refresh sync timestamps and selected accessibility states. Ratings/prices refresh lists immediately. Tapping an already-selected visit status does not invent a missing date.

• Place notes autosave to the place where they were typed, including when switching/closing details or taking an account snapshot. Check-ins refresh sync timestamps; historical visits without dates show Date not recorded.

• Post-save meal cards and original-media collections use only that moment's attachments. A meal without photos stays photo-free rather than borrowing pictures or video from an earlier visit. Place-detail sharing still uses the place's saved personal photos.

• Choose photos or video selects existing media from your device. In Quick Add it is a prominent outlined button above Take photo and Record video. Existing selections are appended, not replaced.

• Card previews always offer Share card, Save image, and Copy text. Share card opens native file sharing when supported; unsupported or blocked sharing explains the manual save-and-upload workflow without auto-downloading.

• In Quick Add, tap a personal thumbnail to choose the cover photo. Previews stay compact, removal buttons are touch-sized, and Save stays pinned inside the scrolling sheet. Captions can also be edited directly in the card preview; blocked clipboard access reveals the text for manual copying.

• Selected profile photos survive same-account login/restores. Legacy cloud defaults do not erase a personal photo; explicit photo changes/removals have their own timestamp, separate from appearance settings. Profile uploads are compressed before saving and Save waits for processing. Account switches discard late uploads and never share another account's photo.

• Share my place card previews a clean 1080x1920 card with the restaurant name, saved address, and up to three of your own attached photos (including a video's poster frame). Place-detail sharing uses the same design. Listing/stock photos are never substituted. Without a personal photo the card is text-only; unreadable attached photos report an error. Original photo/video sharing remains a separate choice.

• Add up to 10 photos and one video clip per moment, with removable previews. The cover showcases up to three photos; expand Your original photos & video in its preview to share the cover and originals together when supported, or save individual files for uploading. Video still follows the existing Grizzly, 15-second and recording-device limits. Large photo collections remain on this device; cloud backups may trim photos to stay within the existing per-place document budget.

• Optional My notes, ratings, dish and AI tools stay under Add details. More details opens the full form without discarding attached media, notes, rating, dish or visit status. Discovery, friends and planning features remain available through their existing entry points.

• Add starts with the place name or link, then Here now, Went before, or Want to try. Add a photo if you like and save; ratings, dishes, cuisine and AI fill are tucked under Add details. Bulk import is a separate expandable option, not another required step.

• Went before allows an optional visit date under Add details. Unknown dates stay unknown rather than being recorded as today. Sharing stays optional and appears only after the place is saved.

• Quick Add, Just Ate, and the full Add form offer Take photo, Record video, and Choose photos or video. Recording uses the rear-camera capture intent on supported phones; desktop browsers may offer a file picker instead. If camera access is denied, allow it in device settings or select existing media.

• Quick Add highlights both camera actions with full-width buttons and a gentle, finite glow that respects reduced motion. Post-save sharing names TikTok, Instagram and Facebook: choose an available installed app in the share sheet, or expand the social posting help to save your media and copy your edited caption for manual upload. Apps control which files and captions they accept; Feed The Bear does not connect social accounts or auto-publish.

• Saving is disabled while media is being picked or processed. Closing or replacing a form discards late picker results rather than attaching them to another place. Grizzly videos remain limited to 15 seconds and stay on the recording device; their poster photos can be backed up.

• After a new place or meal is saved, choose Share photo/video, Make Story card, or Done. Actual files go to the device share sheet, where you choose an installed social app. Browsers without file sharing offer a download instead. Sharing does not automatically publish a post, and blocked sharing is reported explicitly.

• Sign-out immediately hides the account's spots, profile, friends, chats, lists and pending sharing UI. Local account copies are kept in IndexedDB separately, so signing back into the same account can recover unsynced edits. Only a never-signed-in guest diary is automatically adopted on first sign-in. Older signed-out diaries with a remembered email are restored only when that same email signs in.

• Account deletion waits for local sign-out cleanup before erasing device storage. If you explicitly keep your local spots, they become a signed-out diary; the deleted account's profile, friends and chats are not kept with it.

• Theme and display preferences remain on the device. Signing into another account does not import the previous account's diary. Stale cloud loads, uploads, shared-list listeners and chat responses cannot repopulate the app after the session changes.

• Cloud failures show Retry backup and retain local edits. A failed cloud restore blocks uploads until a successful retry; reconnecting retries automatically. Signing in is not advertised as proof that backup succeeded. Persistent sign-in requires browser/site storage; storage failures are shown.

• Before release, test camera permissions, cancellation, photos/video and social share targets on physical Android and iPhone devices. Browser tests verify capture input attributes and native-share payloads, not camera hardware.

Food dates and friends

• Use Plan a food date from Friends or the Friends feed on Home. Pick a time on a shared food interest preselects that friend and spot. Choose a saved place, friend or group, optional date/time and a short message. The invitation preview is exactly what is sent or copied.
• Send the invitation through your device share sheet, copy it to a group chat, or make a 1080x1920 invite card. These are invitations, not reservations, calendar bookings or automatic messages to followers.
• Post-save sharing includes editable captions and Go together. Meal notes enter Story cards only if you explicitly opt in. Want-to-Try cards are labelled as food bucket-list picks, not meals eaten.
• Friends' activity can help you save your first place, even with an empty diary. Account changes hide pending invitations and invalidate slow card generation without breaking the feed controls.

Managing places and finding competitions

• The default appearance is the readable Dark theme, on phones and web, regardless of the phone's system theme. Use the sun/moon button in the header to switch instantly, or choose Settings → Theme → Light. Your choice is saved. Auto (match my phone) is opt-in.

• Use Delete next to Edit on a saved-place card to remove it after confirmation (also available inside the place). Use Mark permanently closed to keep its visits, ratings, notes and photos without suggesting it again. Mark reopened reverses the closure; the flag syncs with the place.

• Open Bear Challenges → See all on Home, or Bear Challenges in Play (phone) / Discover (desktop). Filter restaurant challenges separately from dated competitions and festivals, choose a state without location permission, search a city or restaurant, or browse this weekend.

• Want to go keeps challenge details in Saved on this device, even when an event ends or disappears from discovery. Saves are local, not account-synced; clearing browser data removes them. Invite friends shares a link back to the listing plus its source when available.

• Details show available prize, entry cost, rules, eligibility, source and registration links. Unknown facts stay unconfirmed. The discovery date means a web search found the listing, not organizer verification. Confirm availability and rules with the organizer before going. Older cached results are labelled; failed discovery offers Refresh and Saved.

• Byte Cub understands requests such as "add the Subway on Waddell to visited and note they have the broccoli cheddar soup". He preserves the branch, confirms map matches, and saves availability notes without claiming you ate the dish. When a branch cannot be verified, he asks instead of substituting another place.

• Main search and its mic show matching saved places and restaurants already loaded nearby. Nearby matches are labelled not saved and offer Save; Search nearby searches further using your current location. Voice also understands "find" / "search for" before a restaurant name.

• Friend invites open sharing directly from Send invite or Skip, so iPhone browsers can open the share sheet. If sharing is blocked, choose Text message, WhatsApp, Email or Copy. A blocked clipboard leaves the full invite selectable on screen instead of relying on a browser prompt.

Tests

Browser tests drive the app with Playwright against the local server above.

cd tests
npm install
npm test                        # every *.test.js; keeps going past failures
node run-all.js swipe vote      # only files whose name matches
PW_CHANNEL=msedge npm test      # use an installed browser instead of downloading Chromium

Where things are

• app.html, app.js, style.css: the app
• api/: serverless functions (payments, place info, votes, digest)
• native/: Android app (Capacitor)
• tests/: browser tests
• CHANGELOG.md: what changed and when