Skip to content

New Refetch backend, refetch.io look, and Appwrite Analytics (0.2.0+6) - #16

Merged
lohanidamodar merged 3 commits into
mainfrom
feat/rebrand-appwrite-analytics
Nov 8, 2026
Merged

lohanidamodar merged 3 commits into
mainfrom
feat/rebrand-appwrite-analytics

Conversation

@lohanidamodar

Copy link
Copy Markdown
Collaborator

The refetch.io rewrite removed the REST API this app used, so 0.1.0+5 shows "Request failed, HTTP 404" on every feed. This moves the app onto the new backend, brings it in line with the current site, and adds Appwrite Analytics.

Depends on refetch-io/refetch#13 being deployed first (votes, comments and submissions call its /api/app/* routes).

Data

  • Feeds, stories and comments come straight from Appwrite TablesDB (public-read) with the same queries and quality gates the website runs; comment trees are built client-side like the web's buildCommentTree.
  • Votes, comments, submissions and the viewer's own votes go through /api/app/* with an Appwrite JWT. Submitting is a link plus an optional note, as on the site.
  • appwrite ^24.2.0 → ^28.3.0 (flutter_local_notifications → ^22.3.1, required by it).

Analytics

  • Appwrite Analytics through the SDK's Tracking, behind an AnalyticsService interface (lib/core/analytics/), on the app's own property 6aeff5fb00101bdbf718. --dart-define=ANALYTICS_PROPERTY_ID= compiles it out.
  • Events: screen_view (route observer), feed_loaded / feed_load_failed, thread_load_failed, story_opened, article_opened, story_shared, vote_cast, comment_posted, story_submitted, signed_in / signed_up / signed_out / sign_in_failed, setting_changed.
  • No user id or user-written text is sent. Account › Privacy has a switch (on by default, reachable signed out); events wait for the saved choice and stop when it is off.
  • iOS PrivacyInfo.xcprivacy declares Product Interaction (not linked, not tracking).

Look

  • Colours, type (Poppins titles, Inter body), radii, Lucide icons, logo and wordmark from refetch.io and its DESIGN.md; every value's source is in docs/BRANDING.md (the one file let through the docs/ ignore).
  • Launcher icon is now the purple mark on white (DESIGN.md: never on purple); new splash, Play icon and feature graphic, from tool/render_brand_assets.py.
  • Share any story's thread link; empty and error states in the site's pattern.

Store

  • Version 0.2.0+6; new store copy on the site's tagline "The front page for builders"; changelog 6.
  • iOS privacy URL → https://appwrite.io/privacy (what refetch.io links to; refetch.io/privacy is 404).
  • Play phone screenshots are not refreshed yet.

Checks

  • flutter analyze: no issues. flutter test: 64 passed (new: analytics wrapper, feed queries, models, vote repository, error mapping, time format).
  • Ran on a phone (CPH1989): feed, thread, sign-in and account screens load from the new backend; analytics events accepted by Appwrite (debug logger shows the server's answer); opting out sends nothing, opting back in records setting_changed.
  • Not run end to end: signed-in vote / comment / submit (needs the web deploy). iOS not built (no Mac).

🤖 Generated with Claude Code

lohanidamodar and others added 3 commits November 8, 2026 10:46
…nd add Appwrite Analytics

The refetch.io rewrite removed the REST routes the app read and wrote
through (/api/posts, /api/vote, ...), so the shipped build shows
"Request failed, HTTP 404" on every feed.

Data
- Feeds, stories and comments are read straight from Appwrite TablesDB
  (public-read), with the same queries and quality gates the website
  runs. Comment trees are built client-side like the web's
  buildCommentTree.
- Votes, comments, submissions and the viewer's own votes go through the
  new refetch.io app API (/api/app/*, refetch-io/refetch
  docs/APP_API.md), authenticated with an Appwrite JWT. Submitting is a
  link plus an optional note, as on the site.
- Appwrite transport errors read as "offline" instead of socket text.

Analytics
- Appwrite Analytics (appwrite 28.3.0's Analytics/Tracking) behind an
  AnalyticsService interface, on the app's own property. Screen views via
  a route observer; feed loads/failures, story and article opens,
  shares, votes, comments, submissions, sign-in/up/out and setting
  changes. No user id or user-written text is ever sent.
- A switch in Account > Privacy (on by default, reachable signed out);
  events wait for the saved choice and stop the moment it is off.
- Share any story's thread link from the feed or the thread.

Look
- Colours, type (Poppins titles, Inter body), radii, Lucide icons, logo
  and wordmark from refetch.io and its DESIGN.md; sources in
  docs/BRANDING.md (the one file let through the docs/ ignore).
- New launcher icon (purple mark on white), splash, Play icon and
  feature graphic, generated by tool/render_brand_assets.py.
- Empty and error states in the site's pattern.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
New description, short description, subtitle and promotional text built
on the site's tagline, "The front page for builders"; release notes for
build 6. The iOS privacy URL now points at https://appwrite.io/privacy,
which refetch.io links to: https://refetch.io/privacy returns 404 since
the site rewrite.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Screenshots (Android) and Screenshots (iOS) capture the app with
integration_test + flutter drive on a CI emulator/simulator, frame the
shots with moksha (Refetch purple, Poppins headline, Inter subhead,
checked against each store's rules) and open a PR with the images in the
folders fastlane uploads from. Manual only.

The capture reads the live feed and compiles analytics out, so the runs
never reach the app's stats. Verified on a phone: 4/4 captured and
rendered at 1080x1920.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant