Skip to content

ClearSky is a mobile application that transforms the way users consume trending content from BlueSky. Instead of traditional news format, ClearSky presents trends in a conversational, relatable style, making it feel like you're catching up with a friend rather than reading standard news articles.

License

Notifications You must be signed in to change notification settings

amethystani/NewSky

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

183 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

☁️ ClearSky ☁️

ClearSky Logo

Transforming BlueSky trends into friendly conversations

Version License Status Platform Framework Release Date


πŸ“‹ Table of Contents


🌈 Overview

ClearSky is a mobile application that transforms the way users consume trending content from BlueSky. Instead of traditional news format, ClearSky presents trends in a conversational, relatable style, making it feel like you're catching up with a friend rather than reading standard news articles.

The Problem

Social media trends can be overwhelming, disjointed, and lack personal context. Traditional news aggregators feel impersonal and formal.

The Solution

ClearSky bridges this gap by using advanced AI to convert trending topics into casual, friendly conversations that feel more natural and engaging.

User: "What's trending today?"

ClearSky: "Hey there! So this morning everyone's talking about that new 
satellite launch - apparently it malfunctioned and now there's this whole 
debate about private vs government space programs. What's wild is how the 
company's stock actually went UP after the news broke!"

🌟 Key Features

πŸ“Š Real-Time Trend Aggregation

ClearSky fetches the latest trending topics and posts from BlueSky, ensuring users are always up-to-date with current discussions.

πŸ’¬ Conversational Summaries

Utilizing advanced AI summarization techniques, the app rephrases trending content into a more informal, engaging tone, making information more accessible and enjoyable.

πŸ“± Mobile-First Interface

Clean, intuitive mobile design focused on ease of navigation and readability, optimized for on-the-go consumption.

🎯 Personalized Content

Analyzes user preferences and interactions to tailor trending topics and summaries to individual interests.

πŸ”„ Interactive Elements

Users can engage with content through comments, likes, and shares, fostering a community around shared interests.


πŸ“Έ Screenshots

Main App Screens

Home Screen Interests Page Topics Section
Home Screen Interests Page Topics Section
Top News Settings
Top News Settings

Analytics Dashboard

User Analytics Reading Analytics Engagement Analytics
User Analytics Reading Analytics Engagement Analytics

πŸ—οΈ Technical Architecture

graph TD
    subgraph "Mobile Application"
        A[Flutter UI] --> B[State Management]
        B --> C[API Client]
        A --> D[Local Storage]
        D --> B
    end

    subgraph "Backend Services"
        E[API Gateway/Load Balancer] --> F[Authentication Service]
        E --> G[Content Service]
        E --> H[Analytics Service]
        E --> I[Notification Service]
        
        G --> J[BlueSky API Connector]
        G --> K[Content Processing Engine]
        K --> L[AI Transformation Service]
        
        J --> M[(Content Cache)]
        K --> N[(PostgreSQL Database)]
        H --> O[(Analytics Database)]
        
        P[Background Tasks] --> J
        P --> Q[Trend Detection Algorithm]
        Q --> N
    end
    
    C --> E
    I --> R[Push Notification]
    R --> A
    
    style A fill:#61DAFB,stroke:#333,stroke-width:2px
    style E fill:#FF6B6B,stroke:#333,stroke-width:2px
    style J fill:#6BCB77,stroke:#333,stroke-width:2px
    style L fill:#4D96FF,stroke:#333,stroke-width:2px
    style Q fill:#FFD93D,stroke:#333,stroke-width:2px
Loading

Mobile Application

  • UI Layer: Flutter widgets and screens
  • State Management: Provider pattern or Bloc for reactive state management
  • API Client: REST/GraphQL client with authentication handling
  • Local Storage: SharedPreferences and SQLite for caching and offline access

Backend Services

  • API Gateway: Manages API traffic, authentication, and routing
  • Authentication Service: Handles user authentication and authorization
  • Content Service: Main service for content delivery and management
  • Analytics Service: Collects and processes user behavior and app usage
  • Notification Service: Manages user notifications and push messaging

Data Processing

  • BlueSky API Connector: Integrates with the BlueSky social network API
  • Content Processing Engine: Processes and transforms raw content
  • AI Transformation Service: Uses OpenAI to convert content to conversational format
  • Trend Detection Algorithm: Identifies trending topics using time-series analysis

Data Storage

  • PostgreSQL Database: Primary data storage for users and content
  • Content Cache: Redis for high-speed content caching
  • Analytics Database: Time-series database for user analytics data

Deployment Infrastructure

  • Containerization: Docker for service isolation
  • Orchestration: Kubernetes for service management
  • CI/CD Pipeline: Automated testing and deployment
  • Cloud Provider: AWS/GCP for infrastructure hosting

πŸ“° Daily News Digest

The platform now features an automated daily news digest generation capability that summarizes collected news articles into an easy-to-read format.

Key Features

  • Categorized Content: News articles are automatically grouped by category (Technology, Business, Sports, etc.)
  • AI-Powered Summaries: Uses the powerful PEGASUS model to create concise, readable summaries
  • Source Attribution: Each summary includes attribution to the original source
  • Publication Timestamps: Includes original publication dates when available
  • Daily Updates: Digests are generated with the current date and timestamp

How to Use

Run the digest generation tool with the following command:

# Generate a digest in the default location
python generate_digest.py

# Specify a custom output directory
python generate_digest.py --output-dir path/to/your/directory

Sample Output

The generated digest follows this format:

# DAILY NEWS DIGEST - May 15, 2025

## TECHNOLOGY

1. [Summary of the first technology article...]
   Source: TechCrunch | Date: 2025-05-14

2. [Summary of the second technology article...]
   Source: The Verge | Date: 2025-05-14

## BUSINESS

1. [Summary of a business article...]
   Source: Financial Times | Date: 2025-05-14

[...other categories follow...]

Digest generated on 2025-05-15 08:30:45

πŸ“‹ Implementation Plan

Phase Timeline Deliverables Status
Phase 1: Core Infrastructure Q1 2025 β€’ API connections to BlueSky
β€’ Trend detection algorithms
β€’ Database schema design
🟑 Planning
Phase 2: Content Processing Q2 2025 β€’ AI text transformation
β€’ Content aggregation pipeline
β€’ Content categorization
βšͺ Not Started
Phase 3: Mobile App Development Q3 2025 β€’ Flutter app structure
β€’ Mobile UI components
β€’ Offline capabilities
β€’ Native integrations
βšͺ Not Started
Phase 4: Personalization Q4 2025 β€’ Recommendation algorithms
β€’ User activity tracking
β€’ Personalized feeds
βšͺ Not Started

πŸ“Š Performance Metrics

The application targets the following performance benchmarks:

  • Launch Time: < 2 seconds on mid-range devices
  • Feed Loading: < 1.5 seconds for initial content load
  • Response Time: < 100ms for user interactions
  • Offline Capabilities: Core functionality available without network
  • Battery Impact: < 5% battery usage per hour of active use
  • Storage Footprint: < 100MB base app size

πŸ‘€ User Journey

β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”     β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”     β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚                 β”‚     β”‚                 β”‚     β”‚                 β”‚
β”‚  App Launch &   β”‚ ──▢ β”‚  Customization  β”‚ ──▢ β”‚   Main Feed     β”‚
β”‚   Onboarding    β”‚     β”‚    Profile      β”‚     β”‚                 β”‚
β”‚                 β”‚     β”‚                 β”‚     β”‚                 β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜     β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜     β””β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”˜
                                                         β”‚
β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”     β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”     β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β–Όβ”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚                 β”‚     β”‚                 β”‚     β”‚                 β”‚
β”‚    Sharing &    β”‚ ◀── β”‚   Interaction   β”‚ ◀── β”‚  Content View   β”‚
β”‚   Social Loop   β”‚     β”‚  with Content   β”‚     β”‚                 β”‚
β”‚                 β”‚     β”‚                 β”‚     β”‚                 β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜     β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜     β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜

πŸš€ Future Roadmap

πŸ“± Platform Expansion

  • Tablet-optimized layouts
  • Web application version
  • Desktop companion app

πŸ”Œ Integration Expansion

  • Additional social platform integrations
  • RSS and news source integration
  • Podcast content summarization

πŸ“ˆ Advanced Features

  • Advanced analytics dashboard
  • Content creation tools
  • Media-rich experience enhancements

πŸ’° Monetization

  • Premium subscription model
  • Exclusive content partnerships
  • Enhanced personalization options

πŸ“ Project Status

This is a personal project being developed for publication as a commercial mobile application in 2025. The project is not open for public contributions at this time.

Current Development Stage: Initial Architecture Planning


πŸ‘¨β€πŸ’» Maintainers

amethystani
amethystani
Shricharan
Shricharan

πŸ“„ License

This project is licensed under a proprietary license - see the LICENSE file for details.


πŸ“§ Contact

For questions or inquiries, please reach out to animeshmishra0567@gmail.com

Β© 2025 ClearSky. All Rights Reserved.

About

ClearSky is a mobile application that transforms the way users consume trending content from BlueSky. Instead of traditional news format, ClearSky presents trends in a conversational, relatable style, making it feel like you're catching up with a friend rather than reading standard news articles.

Resources

License

Security policy

Stars

Watchers

Forks

Contributors 2

  •  
  •