Skip to content
The Good App

The Good App — Frontend Documentation

Spread the Good News

UI plan for Login, Home, Profile, News, Article, Community, Create Post, Notifications, Settings, Verification & Moderation.

Login Page

Users securely access their account and engage with positive news. Design: Simple, minimal, encouraging, easy to use, mobile-first. Messaging: “Spread the Good News.”

2. UI Components — Header

Elements: App name “The Good App”, tagline “Spread the Good News”, clean optimistic green-accented design. Purpose: Communicate brand identity and mission.

3. Login Form — Inputs & Validation

Email: placeholder “Email”, valid format, required. Password: placeholder “Password”, masked, required. Validation: valid email; password meets backend security; show inline errors for empty fields, wrong credentials, network error.

5. Primary CTA — Sign In

Prominent green button, label “Sign In”. Disabled until required fields complete (optional). Loading state during auth.

6. Social Login

Below primary button: divider “Or continue with”, then “Continue with Apple”, “Continue with Google”. OAuth; reduce friction, increase conversion.

7. Sign Up Redirect

Bottom text: “Don’t have an account? Sign Up” (Sign Up clickable → Registration). 4. Forgot Password: link “Forgot Password?” → password recovery flow.

8–11. Requirements & Goals

Functional: Secure auth via API, HTTPS, rate limiting, error handling (invalid credentials, account not found, suspended, server error). Non-functional: Load <2s, mobile-first, accessibility (contrast, screen reader, tap targets). UX: Welcoming, fast flow, positivity, encourage registration. Optional: Biometric, “Remember Me”.

Home Page

Main feed: curated positive, verified, uplifting news. Emphasis: optimism, clarity, personalization, engagement, action.

2. Top Navigation

App logo and name “The Good App”; notification icon (top right). Logo tap → top of feed; notification → notifications.

3. Today’s Highlights — Carousel

Horizontally scrollable cards; top curated stories; “View All”. Each card: cover image, category (e.g. Eco Win), headline, engagement (e.g. 12.5K Cheers). Swipe; tap → full article.

4. Category Filters

Rounded filter buttons: All News (default), Environment, Technology, Community, Health, Education. Tap filters feed; selected highlighted; respects country preferences from Profile.

5. Trending Now

Vertically scrollable list. Card: thumbnail, category, verification badge, headline, time (e.g. 2h ago), engagement (e.g. ↑ + count).

6. Floating Action Button

Centered bottom green “+” — opens content creation (share positive news, submit story, upload media).

7. Bottom Navigation

Home, News, Create, Community/Groups, Profile. Persistent; active tab highlighted; fast switching.

8–11. Personalization & Requirements

Logic: country filters, categories, engagement history, trending, verified prioritization. Functional: infinite scroll, pull-to-refresh, lazy load images, real-time engagement, cache. Non-functional: feed <2s, 60fps, image optimization, accessibility. UX: Positivity default, reduce negativity bias, encourage interaction and creation.

Profile Section

Manage identity, customize content, track positive impact. Combines: identity, preferences, impact tracking, achievements.

2. User Information

Editable: profile photo (upload/change/remove), display name, short bio, optional country, join date. Public view: picture, name, bio, XP, impact score (Likes + Views), posts count, followers.

3. Settings — Country Filters

Select one or multiple countries; enable/disable global news; update anytime. Personalize feed by geography.

4. Impact & Achievements

Impact Score = Views + Likes. Levels: 0–100 Good Starter, 101–500 Positive Contributor, 501–2000 Impact Maker, 2000+ Global Optimist. Visible metrics: total impact, level, content posted. Goals: encourage participation, reward impact, promote creation, long-term engagement, recognition culture. Optional: verified creator badge, leaderboard, monthly summary, sharing, themes.

News Section

Structured, credibility-focused feed of verified positive news. Emphasis: verification, source transparency, topic discovery, fast scanning.

2. Header

Title “Verified News”, notification icon. Sticky header; icon opens notification center.

3. Search Bar

Placeholder “Search topics, sources…”. Search by keywords, topics, sources; real-time filtering; dynamic results.

4. Category Filter Tabs

Horizontal rounded buttons: All (default), Humanity, Tech, Science, Nature. Selected highlighted; smooth scroll; instant list update; maintains search if active.

5. Featured Verified Article (Hero)

Large cover, “Verified” badge, category, reading time (e.g. 4m), headline, source, time. Tappable → full article; lazy load; shadow, rounded corners.

6. News List & 7. Verification

Cards: thumbnail, verified badge, headline (2 lines), source, time; optional reading time. Clean white card, rounded, elevation. Verified badge: green with check; content reviewed, source validated; criteria: trusted domain, positive topic, fact-checked, no sensationalism.

8–11. Bottom Nav, Requirements, UX

Persistent: Feed, Search, Saved, Profile. Functional: infinite scroll, lazy load, refresh, category + search filter, API, cache. Non-functional: <2s, 60fps, compression, accessibility. UX: trust via verification, calm consumption, intuitive discovery, deeper reading.

Article Detail Page

Full story in structured, immersive, credibility-focused layout. Goals: deep reading, verification transparency, author credibility, engagement.

2. Hero

Full-width cover image, rounded top, dark overlay. Top overlay: back, bookmark, share. Badge “Community Verified”. Headline, date, reading time (e.g. 4 min read).

3–6. Author, Credibility, Context, Body

Author: image, name, role (e.g. Tech Editor), Follow. Credibility module: e.g. 98% Score, 12k verifications, circular progress. Community Context: clarification, history, technical explanation, neutral framing. Body: clean typography, line spacing, paragraphs, subheadings; inline images with captions, lazy load.

8. Engagement Bar

Bottom: Credible (positive validation), Comment, Share. Credible increments metric; Comment → thread; Share → native sheet. Requirements: scroll, lazy load, bookmark persistence, real-time score, comments, follow, share; error handling. UX: immersive reading, trust, thoughtful engagement.

Community Feed

Social hub: share positive experiences, celebrate achievements, engage with uplifting UGC. Emphasis: recognition, engagement, positive storytelling, collective impact.

2. Header & 3. Top Contributors

Logo, title “Community Feed”, search icon (top right). Sticky. Top: horizontal carousel — profile image, name, win count (e.g. 20+ WINS), rank badge (#1 highlighted). Tap profile → user; “View All” → leaderboard.

4–6. Posts & Engagement

Post: header (avatar, username, time, location, options ⋯); tag (#CommunityWin, #PositiveNews); media (image, rounded); caption, hashtags. Engagement: Like, Comment, Share with counts; like = optimistic update; comment → thread; share → sheet. FAB green “+” for create. Bottom nav: Home, News, Create, Community (active), Profile.

9–11. Requirements & UX

Infinite scroll, pull-to-refresh, real-time engagement, leaderboard logic, hashtag filter, moderation, report, media optimization, follow. Load <2s, 60fps, HTTPS, accessibility. UX: celebrate action, belonging, contribution over scrolling, social reinforcement, visible impact.

Create Post Form

Submit positive news or community wins. Balance ease of use with credibility. Goals: positive storytelling, quality, verification, low friction, responsible sharing.

2. Top Bar

Cancel (left), title “New Post”, Save (right). Cancel → discard (confirm if content); Save → draft; sticky.

3. Media Upload

Centered “ADD MEDIA” with camera icon. Upload image/video (optional), take photo. Compression, preview, replace/remove, max size.

4–6. Title, Category, Description

Title: required, character limit, validation. Category: rounded buttons (Environment, Humanity, Tech, Science, Community, Health); single selection, green highlight. Description: “Tell the community your good news…”, multiline, hashtags, optional limit.

7. Verified Source & 8. Draft

Label “Verified Source” (Required), placeholder URL. Valid URL, HTTPS; required for news (configurable for community wins). URL validation, domain check. Draft: “Draft Saved” near bottom; auto-save on change; recoverable.

9. Review Post & 10–12. Requirements

Large green “Review Post” with verification icon. Validates required fields, opens preview, moderation check, shows errors. Functional: auto-save, media compression, URL validation, category enforcement, moderation, preview, HTTPS, API. Errors: upload fail, invalid URL, missing fields, network. Non-functional: <2s, keyboard behavior, secure storage, accessibility. UX: effortless sharing, responsible publishing, reduce fear, trust, quality.

Notification Center

Updates, engagement, account events. Goals: positive reinforcement, engagement, transparency, security, participation.

2. Header & 3–4. Categories & Card

Title “Notifications”, “Mark all as read”. Sticky. Groups: New, Earlier. Card: icon/avatar, bold title, description, timestamp, unread dot (green).

5. Types & 6–7. Logic & Nav

Types: Reputation (+50 for verification…), Post Approved, Community Note Added, New Follower, Account Security (e.g. new login). Tap → related content/profile/security. Unread = green dot; open = read; “Mark all” clears. Bottom: Home, Explore, Alerts (active), Profile. Real-time push, unread badge, deep link, grouping, mark read, backend sync. Load <2s, secure token, encryption, accessibility. UX: reinforcement, participation, informed without overwhelm, calm, security balance.

App Settings & Privacy

Account preferences, personalization, privacy and security. Goals: autonomy, personalization, security, transparency, trust.

2. Header & 3. Account Summary

Back (→ Profile), title “Settings”. Sticky. Card: avatar, display name, “Verified Member”, Edit (→ profile edit).

4. News Feed Location

Removable chips (e.g. USA, EU, UK). “Add Region” → search countries, suggested list, “+” to add. Updates feed algorithm in real time.

5. Preferences & 6. Privacy & Security

Preferences: Notifications toggle; Dark mode toggle; Content language (e.g. English US) → language screen. Privacy: “Allow community to see wins” (ON/OFF); Blocked accounts (list, unblock); Change password (secure flow, current pwd, strong pwd, HTTPS). 7. Community: Guidelines, Help & Support. 8. Log Out: red button, confirmation modal; token invalidation, session clear. 9. Version (e.g. 1.0.4). Real-time prefs, auth, session, region filter, theme persistence, i18n, privacy enforcement; error handling.

Post Verification — Trust Pipeline

Informs user content is under validation. Ensures accuracy, credibility, community moderation, transparency. Value: Trust Before Reach.

2. Entry & 3. Header

Shown when: user submits post, post needs verification, flagged re-review. Header: “Status”, Close (X) → previous; review continues in background.

4–5. Status Card & Pipeline

Visual: Green shield (optional glow). Title “Under Review”. Description: “Your post is moving through our Trust Pipeline…”. Pipeline: AI Fact Check — “In Progress”, “Analyzing sources & context” (automated fact check, NLP, risk score); Community Verification — “Waiting”, “Pending approval” (peer review, unlocks after AI). 6. Estimated time: e.g. “< 2 minutes” (dynamic). 7. “Notify me when live” — push when approved; token, trigger, real-time. 8. “View Submission Guidelines”. 9. Backend flow: Submit → Pending → AI → score → if OK Community Review → Live or Needs Revision. Edge: low AI confidence, conflicting votes, admin escalation. Real-time updates, push.

Admin Moderation Panel

Admin interface for moderators/trust managers: review, approve, reject, escalate flagged content. AI-assisted, community reports, escalation, platform safety.

2. Access & 3. Navigation

Roles: Admins, Senior Moderators, Trust & Safety. RBAC, 2FA recommended, session timeout, action logging. Title “Moderation Queue”. Tabs: Pending (awaiting), Escalated (high-risk), Resolved (approved/rejected/banned).

4. Metrics & 5–9. Cards & Actions

Metrics: Queue size (e.g. 42, trend ↓12%), Avg response time (e.g. 2m, “Fast”), Escalations (e.g. 5, % change). Card: author, username, timestamp, verification badge, overflow ⋯. AI: Toxicity (e.g. 2% Safe, 88% High Risk); color green/yellow/red. Source Match (e.g. 98%, 0%, Unverified). Actions: Approve (live, reputation up, Resolved); Reject (not published, feedback, optional rep deduction); Ban & Reject (remove, suspend/ban, log); Escalate (senior mod, legal, board). Flagged: red border + “FLAGGED” (reports, high toxicity, repeat offender). Workflow: post in → AI score → auto-approve / queue / escalation → moderator → reputation update → log. Real-time queue, AI integration, risk filter, search, logging, user notification. Availability, secure env, traceability, low latency, scalable. Analytics: moderator performance, accuracy, false +/- , resolution time, reoffender rates.