https://github.com/odevthomas/news-word
This project is a modern and responsive news application that utilizes the News API to provide the latest and most relevant articles.
https://github.com/odevthomas/news-word
Last synced: 12 months ago
JSON representation
This project is a modern and responsive news application that utilizes the News API to provide the latest and most relevant articles.
- Host: GitHub
- URL: https://github.com/odevthomas/news-word
- Owner: odevthomas
- Created: 2024-08-07T21:55:56.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2024-08-09T13:55:03.000Z (over 1 year ago)
- Last Synced: 2025-01-30T15:41:36.182Z (about 1 year ago)
- Language: JavaScript
- Homepage: https://news-word-seven.vercel.app
- Size: 418 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# 🌍 WORLD News
Welcome to **WORLD News**! This project is a modern and responsive news app that uses the News API to deliver the latest and most relevant articles. With a clean interface and useful features, WORLD News keeps you up to date with the latest news.
## 📦 Features
### 📰 **News from Multiple Sources**
- **Wall Street Journal**: Access recent articles from the Wall Street Journal.
- **TechCrunch**: Top headlines and articles about technology from TechCrunch.
- **Business**: Latest business news and trends in the US.
- **Tesla**: News about Tesla, including recent updates.
- **Apple**: Articles and news about Apple.
### 🖼️ **Hero Section**
- Displays an inspirational quote of the day and a random image. - Highlights a welcome message and a brief description about the site's mission.
### 🔍 **Search**
- Modernly styled search field to search for news directly on the site.
### 📱 **Responsive**
- Responsive design that adjusts for an optimized user experience across different devices, including desktops and mobile devices.
### 🛠️ **Components**
- **NavBar**: Fixed navigation at the top of the page, with links to different news categories.
- **News**: Component that displays news based on the source provided via API URL.
## 🚀 How to Get Started
### 📝 **Prerequisites**
Make sure you have [Node.js](https://nodejs.org/) and [npm](https://www.npmjs.com/) installed on your machine.
### 🔧 **Installation**
1. Clone the repository:
```bash
git clone https://github.com/your-username/world-news.git
```
2. Navigate to the project directory:
```bash
cd world-news
```
3. Install the dependencies:
```bash
npm install
```
4. Start the development server:
```bash
npm start
```
The application will be available at [http://localhost:3000](http://localhost:3000).
## 📚 **Project Structure**
- `src/components/`: Contains all React components, including Navbar, HeroSection and News.
- `src/App.js`: Route configuration and main structure of the application.
- `src/App.css`: Global application styles.
- `src/components/NavBar/NavBar.css`: Styles specific to the Navbar.
- `src/components/HeroSection/HeroSection.css`: Styles specific to the HeroSection.
## 🌟 **Contributions**
Contributions are welcome! If you want to improve the project or add new features, follow the steps below:
1. Fork the repository.
2. Create a new branch (`git checkout -b feature/new-feature`).
3. Make your changes and commit (`git commit -am 'Add new feature'`).
4. Push to the remote repository (`git push origin feature/new-feature`).
5. Open a pull request.
## 📝 **License**
This project is licensed under the [MIT License](LICENSE). See the `LICENSE` file for more details.
## 📧 **Contact**
For any questions or suggestions, please contact us by email: [your-email@domain.com](mailto:developer.thomas@outlook.com.br).