Skip to content

Repository files navigation

PulseStream

A multi-source developer content aggregator built with React, bringing technical news and developer discussions from different platforms into one unified dashboard.

PulseStream was built as my first React project to practice working with APIs, asynchronous data, state management, data normalization, caching, reusable components, and responsive UI development.

Features

  • Unified Feed — Combines content from Hacker News, Dev.to, and Reddit into a single feed.
  • Global Search — Search across available stories.
  • Source Filtering — Filter stories by Hacker News, Dev.to, Reddit, or view all sources.
  • Article Inspector — Open a story and view its information before visiting the original source.
  • Bookmarks — Save stories for later using browser LocalStorage.
  • Share — Generate and copy shareable story information.
  • Analytics Dashboard — View feed activity and content insights using Recharts.
  • API Health Monitor — Monitor API availability and response latency.
  • Cache Management — Manage TanStack Query cache and stored application data.
  • Live Weather — Displays current weather information using Open-Meteo.
  • Live Clock — Displays the current local time.
  • Live Ticker — Displays trending information from the available feed data.
  • Theme Customization — Switch between different accent themes and adjust font scaling.
  • Responsive Design — Designed to work across desktop, tablet, and mobile screens.

Tech Stack

  • React
  • JavaScript (ES6+)
  • Vite
  • Tailwind CSS
  • TanStack Query
  • Recharts
  • Lucide React
  • LocalStorage
  • Public REST APIs

APIs

PulseStream currently works with:

  • Hacker News API — Developer and technology stories
  • Dev.to API — Developer articles and discussions
  • Reddit — Community discussions from selected technology-related subreddits
  • Open-Meteo API — Weather information

What I Practiced

This project helped me apply several React and JavaScript concepts in a real application, including:

  • React components and props
  • React state and effects
  • API requests and asynchronous JavaScript
  • TanStack Query
  • Data normalization
  • Array methods such as map() and filter()
  • Spread syntax
  • Conditional rendering
  • Loading and error states
  • Client-side caching
  • LocalStorage
  • Responsive UI development
  • Data visualization with Recharts

Project Status

In Progress

PulseStream is currently functional and actively being refined. The core API integrations, unified feed, search, filtering, bookmarks, analytics, caching, and responsive interface have been implemented.

Future improvements will focus on UI/UX refinement, performance optimization, and additional polish.

Author

Chioma Okwara

IT Student & Aspiring Software Developer

About

A high-performance React content aggregator that combines developer news and discussions from multiple APIs into a unified, real time intelligence dashboard.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages