Skip to content

rbalogic/react-hackernews-client

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

3 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

HackerNews Client

A minimal HackerNews client built with React, providing a clean and efficient interface for browsing trending stories, comments, and user profiles.

Overview

This project is a lightweight React application that fetches real-time data from the HackerNews API. It demonstrates modern React patterns including component composition, state management, and API integration.

Features (In Progress)

  • ✅ Browse top HackerNews stories
  • ✅ View story details and comments
  • 🚧 User profile pages
  • 🚧 Favorite/bookmark stories
  • 🚧 Search functionality
  • 🚧 Dark mode support
  • 🚧 Responsive mobile design

Tech Stack

  • React - UI library
  • JavaScript (ES6+) - Language
  • HackerNews API - Data source
  • HTML5 - Markup

Installation

# Clone the repository
git clone https://github.com/rbalogic/react-hackernews-client.git

# Navigate to the project
cd react-hackernews-client

# Install dependencies
npm install

# Start the development server
npm start

The application will run on http://localhost:3000

Project Structure

src/
├── components/      # React components
├── pages/          # Page components
├── services/       # API services
├── styles/         # CSS files
└── App.js          # Main App component

API

This project uses the official HackerNews API:

  • Base URL: https://hacker-news.firebaseio.com/v0
  • No authentication required
  • Fetch stories, comments, and user data

Development Status

🚧 This project is under active development. Features and components are being built incrementally.

Completed

  • Basic story listing
  • Story details view
  • Comment fetching

In Progress

  • User profiles
  • Bookmarking system
  • Performance optimization

TODO

  • Search functionality
  • Dark mode
  • Mobile responsiveness
  • Unit tests
  • Error handling improvements

Contributing

Contributions are welcome! Feel free to fork the repository and submit pull requests for any improvements.

License

This project is open source and available under the MIT License.

Resources


Note: This project is a work in progress. Check back for updates!

About

A minimal HackerNews client built with React. Features a clean interface for browsing top stories, comments, and user profiles with real-time data fetching from the HackerNews API.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors