https://github.com/jlokitha/newscurator-frontend

NewsCurator is a personalized news dashboard mobile app built with React Native and Expo, aggregating articles from NewsAPI. Filter news, bookmark articles, and manage profiles.
https://github.com/jlokitha/newscurator-frontend

axios expo mobile nativewind newsapi personalized react-native redux

Last synced: 5 months ago
JSON representation

NewsCurator is a personalized news dashboard mobile app built with React Native and Expo, aggregating articles from NewsAPI. Filter news, bookmark articles, and manage profiles.

Host: GitHub
URL: https://github.com/jlokitha/newscurator-frontend
Owner: jlokitha
License: mit
Created: 2025-02-28T12:46:42.000Z (over 1 year ago)
Default Branch: main
Last Pushed: 2025-03-01T21:11:55.000Z (over 1 year ago)
Last Synced: 2025-06-04T08:57:31.596Z (about 1 year ago)
Topics: axios, expo, mobile, nativewind, newsapi, personalized, react-native, redux
Language: TypeScript
Homepage:
Size: 83 KB
Stars: 1
Watchers: 1
Forks: 0
Open Issues: 0
Metadata Files:
- Readme: README.md

Awesome Lists containing this project

README

NewsCurator Frontend

NewsCurator is a personalized news dashboard mobile application built with React Native and Expo. The app aggregates trending articles from NewsAPI and lets users filter news by interests (tech, science, etc.), bookmark favorite articles, and manage their profile—all through an intuitive, user-friendly interface.

---

Table of Contents

- [Overview](#overview)
- [Features](#features)
- [Tech Stack](#tech-stack)
- [Getting Started](#getting-started)
- [Prerequisites](#prerequisites)
- [Installation](#installation)
- [Backend Repository](#backend-repository)
- [Postman Collection](#postman-collection)
- [License](#license)

---

## Overview

NewsCurator delivers a personalized news experience by:
- Presenting trending articles based on user interests.
- Enabling users to filter news using common tags or custom text searches.
- Offering bookmark functionality to save and manage favorite articles.
- Providing a secure user authentication system with JWT-based sign-up and sign-in.
- Allowing users to review their profile details and logout seamlessly.

---

## Features

- **User Authentication:**
Secure sign-up and sign-in with JWT authentication.

- **News Dashboard:**
- Loads trending news articles from NewsAPI with pagination support.
- Allows filtering by predefined tags (e.g., tech, science) and custom search queries.

- **Bookmark Management:**
- Bookmark favorite news articles.
- View and delete bookmarks from a dedicated section.

- **User Profile:**
- Access personal details.
- Logout functionality to ensure a secure session.

---

## Tech Stack

- **React Native & Expo:**
Cross-platform mobile development with Expo.
- **TypeScript:**
Robust and scalable code with static type-checking.
- **Redux & Redux-Thunk:**
Efficient state management and asynchronous API integration.
- **Axios:**
Simplified HTTP requests to the backend API.
- **NativeWind:**
Utility-first styling for rapid and responsive design.

---

## Getting Started

### Prerequisites

- [Node.js](https://nodejs.org/en/download)
- [npm](https://docs.npmjs.com/downloading-and-installing-node-js-and-npm)
- [Expo CLI](https://docs.expo.dev/get-started/installation/)

### Installation

1. **Clone the Repository:**
```bash
git clone https://github.com/jlokitha/NewsCurator-Frontend.git
cd NewsCurator-Frontend
```

2. **Install Dependencies:**
```bash
npm install
```

3. **Run the Application:**
```bash
npm start
```
or
```bash
expo start
```

4. **Test on Device/Emulator:**
- Scan the QR code with the Expo Go app on your mobile device.
- Alternatively, run on an emulator using the provided Expo options.

---

## Backend Repository

Access the NewsCurator Backend repository on GitHub [here](https://github.com/jlokitha/NewsCurator-Backend.git).

---

## Postman Collection

For API testing and integration details, check out the Postman collection [here](https://documenter.getpostman.com/view/35384124/2sAYdhLAyB).

---

## License

This project is licensed under the [MIT License](LICENSE).

---