mikunshub/hackersfeed

HackersFeed - Tech News Aggregator

HackersFeed is a web application designed to streamline navigation through tech-related news from Hacker News. It provides an intuitive interface for browsing, searching, and filtering news items, along with the ability to add new items via an API. The project utilizes a combination of Next.js for the frontend and Django for the backend.

Stack

• Frontend: Built using Next.js, a popular React framework for building modern web applications. It offers server-rendered React applications and features like server-side rendering, static site generation, and routing.

• Backend: Developed using Django, a high-level Python web framework that promotes rapid development and clean, pragmatic design. It includes powerful features such as an Object-Relational Mapping (ORM) system and built-in administrative interface.

Getting Started

To run the HackersFeed application, you'll need to set up both the frontend and backend components. Follow the steps below to get started:

Frontend

For detailed instructions on setting up and running the frontend, refer to the frontend.md file.

Backend

For detailed instructions on setting up and running the backend, refer to the backend.md file.

Features

• Scheduled Sync: The backend includes a scheduled job that syncs published news items from the Hacker News API every 5 minutes.

• News Listing: The frontend provides a view to list the latest news items, with options to filter by item type and search by text.

• Post jobs and tech stories around you: Showcase job opportunities or share your own tech-related stories within the community. Create posts to connect with like-minded individuals and explore new opportunities in the tech world.

• Anonymous Commenting: Engage in discussions freely with the ability to leave anonymous comments on news items. Share your thoughts without the need to reveal your identity.

• API: The application exposes an API with endpoints to list items, apply filters, and add new items.

Get Involved

Contributions to HackersFeed are welcome! Feel free to fork the repository, make improvements, and submit pull requests. If you have any questions or feedback, please don't hesitate to reach out.