1
1
---
2
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 ]
3
+ description : A personalized news app combining vertical feed discovery with AI-powered deep dives using Perplexity Sonar Pro and Deep Research models
4
+ sidebar_position : 17
5
+ keywords : [flow and focus, perplexity sonar , news personalization, dual-mode, next .js, react, ai ]
6
6
---
7
7
8
- # Flow & Focus | Personalized News for Genuine Understanding
8
+ ** Flow & Focus** is a personalized news application that transforms news consumption into a learning experience. It uniquely combines rapid discovery through a vertical news feed (Flow) with in-depth, interactive learning dialogues (Focus), powered by Perplexity's Sonar Pro and Sonar Deep Research models.
9
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.
10
+ <iframe
11
+ className = " w-full aspect-video rounded-xl"
12
+ src = " https://www.youtube.com/embed/09h7zluuhQI"
13
+ title = " YouTube video player"
14
+ frameBorder = " 0"
15
+ allow = " accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture"
16
+ allowFullScreen
17
+ ></iframe >
11
18
12
19
## Features
13
20
@@ -19,10 +26,6 @@ keywords: [Flow & Focus, Perplexity Hackathon, news personalization, Sonar Pro,
19
26
* ** Real-time Content** : Leverages Sonar Pro for up-to-date news and Sonar Deep Research for detailed analysis
20
27
* ** Visual Enhancement** : Dynamic background images generated via Runware.ai based on content keywords
21
28
22
- ## Demo
23
-
24
- [ ![ Flow & Focus Demo] ( https://img.youtube.com/vi/09h7zluuhQI/0.jpg )] ( https://www.youtube.com/watch?v=09h7zluuhQI )
25
-
26
29
27
30
## Prerequisites
28
31
@@ -34,33 +37,49 @@ keywords: [Flow & Focus, Perplexity Hackathon, news personalization, Sonar Pro,
34
37
## Installation
35
38
36
39
``` bash
40
+ # Clone the repository
37
41
git clone https://github.com/michitomo/NewsReel.git
38
42
cd NewsReel
39
- npm install
40
43
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
44
+ # Install dependencies
45
+ npm install
45
46
46
- # Start development server
47
- npm run dev
47
+ # Set up environment variables
48
+ cp .env.example .env.local
48
49
```
49
50
50
- ## Architecture
51
+ ## Configuration
51
52
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
53
+ Create ` .env.local ` file:
54
+ ``` ini
55
+ PERPLEXITY_API_KEY =your_perplexity_api_key_here
56
+ RUNWARE_API_KEY =your_runware_api_key_here
57
+ PERPLEXITY_FOCUS_MODEL =sonar-deep-research
58
+ ```
57
59
58
60
## Usage
59
61
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
62
+ 1 . ** Start Development Server** :
63
+ ``` bash
64
+ npm run dev
65
+ ```
66
+
67
+ 2 . ** Access Application** : Open http://localhost:3000 in your browser
68
+
69
+ 3 . ** Flow Feed** : Scroll vertically through news snippets and tap key phrases for deep dives
70
+
71
+ 4 . ** Focus Mode** : Generate personalized digests with interactive conversation segments
72
+
73
+ 5 . ** Personalization** : Your viewing patterns automatically influence content selection
74
+
75
+ ## Code Explanation
76
+
77
+ * ** Frontend** : Next.js 15 with React 19, TypeScript, Tailwind CSS, and Framer Motion for animations
78
+ * ** State Management** : Zustand with localStorage persistence for user preferences
79
+ * ** AI Integration** : Perplexity Sonar Pro for real-time news and Sonar Deep Research for in-depth analysis
80
+ * ** Image Generation** : Runware SDK integration for dynamic background images based on content keywords
81
+ * ** API Routes** : Server-side integration handling Perplexity and Runware API calls
82
+ * ** Mobile-First Design** : Swipe gestures and responsive layout for intuitive mobile experience
64
83
65
84
## Links
66
85
0 commit comments