Skip to content

Commit bab2937

Browse files
michitomoclaude
andauthored
docs(showcase): add Flow & Focus project
Add comprehensive showcase entry for Flow & Focus, a dual-mode news app combining vertical feed discovery with AI-powered deep dives using Perplexity Sonar Pro and Deep Research models. Includes demo video thumbnail and GitHub repository link. 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <[email protected]>
1 parent 9da3edd commit bab2937

File tree

1 file changed

+70
-0
lines changed

1 file changed

+70
-0
lines changed

docs/showcase/flow-and-focus.mdx

Lines changed: 70 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,70 @@
1+
---
2+
title: Flow & Focus | Personalized News for Genuine Understanding
3+
description: Dual-mode news app combining vertical feed discovery with AI-powered deep dives using Perplexity Sonar
4+
sidebar_position: 6
5+
keywords: [Flow & Focus, Perplexity Hackathon, news personalization, Sonar Pro, Sonar Deep Research, Next.js, React]
6+
---
7+
8+
# Flow & Focus | Personalized News for Genuine Understanding
9+
10+
**Flow & Focus** reclaims your curiosity by transforming news consumption into a personalized learning experience. It uniquely combines the rapid discovery of a vertical news feed (Flow) with in-depth, interactive learning dialogues (Focus), powered by Perplexity's Sonar Pro and Sonar Deep Research models.
11+
12+
## Features
13+
14+
* **Dual Mode Interface**: Flow Feed for quick news discovery and Focus for personalized deep dives
15+
* **Vertical News Feed**: Swipeable news snippets with AI-generated summaries, tags, and background images
16+
* **Interactive Deep Dives**: Tap key phrases for focused content, with horizontally scrollable detail panes
17+
* **Personalized Learning**: AI-powered conversation segments with personas like "Oracle" and "Explorer"
18+
* **Smart Personalization**: Tracks reading patterns to tailor content selection automatically
19+
* **Real-time Content**: Leverages Sonar Pro for up-to-date news and Sonar Deep Research for detailed analysis
20+
* **Visual Enhancement**: Dynamic background images generated via Runware.ai based on content keywords
21+
22+
## Demo
23+
24+
[![Flow & Focus Demo](https://img.youtube.com/vi/09h7zluuhQI/0.jpg)](https://www.youtube.com/watch?v=09h7zluuhQI)
25+
26+
27+
## Prerequisites
28+
29+
* Node.js 18+ and npm
30+
* Perplexity API key
31+
* Runware API key for image generation
32+
* Next.js 15 and React 19 environment
33+
34+
## Installation
35+
36+
```bash
37+
git clone https://github.com/michitomo/NewsReel.git
38+
cd NewsReel
39+
npm install
40+
41+
# Create .env.local with your API keys
42+
echo "PERPLEXITY_API_KEY=your_perplexity_api_key_here" > .env.local
43+
echo "RUNWARE_API_KEY=your_runware_api_key_here" >> .env.local
44+
echo "PERPLEXITY_FOCUS_MODEL=sonar-deep-research" >> .env.local
45+
46+
# Start development server
47+
npm run dev
48+
```
49+
50+
## Architecture
51+
52+
* **Frontend**: Next.js 15, React 19, TypeScript, Tailwind CSS, Framer Motion
53+
* **State Management**: Zustand with localStorage persistence
54+
* **LLM Integration**: Perplexity Sonar Pro (real-time news) and Sonar Deep Research (in-depth analysis)
55+
* **Image Generation**: Runware SDK with keyword-based prompting
56+
* **API Routes**: Server-side integration with Perplexity and Runware APIs
57+
58+
## Usage
59+
60+
1. **Flow Feed**: Scroll vertically through news snippets, tap key phrases for deep dives
61+
2. **Focus Mode**: Generate personalized digests with interactive conversation segments
62+
3. **Personalization**: Your viewing patterns automatically influence content selection
63+
4. **Navigation**: Swipe gestures for intuitive mobile-first experience
64+
65+
## Links
66+
67+
* [GitHub Repository](https://github.com/michitomo/NewsReel)
68+
* [Demo Video](https://www.youtube.com/watch?v=09h7zluuhQI)
69+
* [Perplexity Hackathon](https://perplexityhackathon.devpost.com/)
70+
* [Perplexity Hackathon Project](https://devpost.com/software/flow-focus)

0 commit comments

Comments
 (0)