Skip to content

COMPARISON.md

Latest commit

 

History

History
185 lines (147 loc) · 5.14 KB

COMPARISON.md

File metadata and controls

185 lines (147 loc) · 5.14 KB

Twitter vs GitHub Issues App - Key Differences

Overview

Both apps follow the same architecture pattern but are customized for their respective platforms.

Architecture Similarities

✅ FastAPI backend ✅ File-based storage with Railway persistence ✅ OAuth 2.0 authentication ✅ OMI webhook integration ✅ AI-powered content processing (OpenAI) ✅ Mobile-first UI ✅ Session management for segment collection

Key Differences

1. Segment Collection

Feature Twitter App GitHub App
Trigger phrase "Tweet Now" "Feedback Post"
Segments collected 3 5
Reasoning Quick tweets (10-15s) Detailed issues (15-20s)

2. Authentication

Feature Twitter App GitHub App
OAuth Provider Twitter OAuth 2.0 (Tweepy) GitHub OAuth 2.0 (direct)
Scopes tweet.read, tweet.write, users.read repo
Token Refresh Automatic refresh token handling No refresh (long-lived tokens)
OAuth Library Tweepy's OAuth2UserHandler Direct requests

3. Content Processing

Feature Twitter App GitHub App
AI Output Single cleaned tweet text Title + Description
Formatting Tweet cleanup (280 chars) Professional issue format
Extra features Filler word removal Structure: problem, context, details

4. User Settings

Feature Twitter App GitHub App
Configuration None (just auth) Repository selection
Homepage Simple instructions Full settings page
Settings Updates N/A Change repo anytime
Repo Management N/A Refresh repos, select target

5. Output

Feature Twitter App GitHub App
Creates Tweet on Twitter Issue on GitHub
Returns Tweet text + ID Issue title + number + URL
Labels N/A Adds "voice-feedback" label
Format Single text string Title + multi-line description

File Structure Comparison

Twitter App (/apps/twitter/)

main_simple.py          # Main FastAPI app
twitter_client.py       # Twitter API with Tweepy
tweet_detector.py       # Tweet extraction + AI cleanup
simple_storage.py       # Users + sessions storage

GitHub App (/apps/github/)

main.py                 # Main FastAPI app + mobile UI
github_client.py        # GitHub API (direct requests)
issue_detector.py       # Issue generation + AI formatting
simple_storage.py       # Users + sessions + repo prefs

UI Differences

Twitter App

  • Minimal setup page
  • Just "Connect Twitter" button
  • Focus on quick start

GitHub App

  • Full settings dashboard
  • Repository dropdown selector
  • "Save Repository" and "Refresh Repos" buttons
  • Mobile-first responsive design with GitHub color scheme
  • Step-by-step usage guide
  • Settings management UI

Code Examples

Twitter: Processing

# Collect 3 segments
if segments_count >= 3:
    # AI extracts single tweet
    cleaned_content = await tweet_detector.ai_extract_tweet_from_segments(accumulated)
    # Post tweet
    result = await twitter_client.post_tweet(access_token, cleaned_content)

GitHub: Processing

# Collect 5 segments
if segments_count >= 5:
    # AI generates title + description
    title, description = await issue_detector.ai_generate_issue_from_segments(accumulated)
    # Create issue
    result = await github_client.create_issue(access_token, repo_full_name, title, description)

Storage Differences

Twitter

users[uid] = {
    "uid": uid,
    "access_token": ...,
    "refresh_token": ...,
    "expires_at": ...
}

GitHub

users[uid] = {
    "uid": uid,
    "access_token": ...,
    "github_username": ...,
    "selected_repo": ...,        # NEW: repo selection
    "available_repos": [...]     # NEW: repo list
}

AI Prompts Comparison

Twitter

  • Goal: Clean up tweet, remove filler words
  • Output: Single text string (280 chars max)
  • Focus: Natural, concise, well-formatted tweet

GitHub

  • Goal: Extract problem and format professionally
  • Output: Title (concise) + Description (detailed)
  • Focus: Clear problem statement, context, technical details

Mobile-First UI

Twitter App

  • Basic HTML with inline styles
  • Centered cards
  • Simple gradient background

GitHub App

  • Comprehensive CSS with GitHub theming
  • Dark gradient background (#24292e)
  • Step-by-step visual guides
  • Responsive cards and buttons
  • Repository management interface
  • Status indicators (connected/disconnected)

Deployment

Both apps:

  • ✅ Deploy to Railway
  • ✅ Use persistent /app/data volume
  • ✅ Environment variables for secrets
  • ✅ Health check endpoints
  • ✅ Same Python version (3.10.17)

Summary

The GitHub app is essentially the Twitter app enhanced with:

  1. 5 segments instead of 3 (more detail needed)
  2. Repository selection (multi-project support)
  3. Title + Description generation (structured output)
  4. Settings management UI (change repos after setup)
  5. Mobile-first design (better UX)
  6. Direct OAuth (no library dependency like Tweepy)