sarpbozk / flutnews

A local news app that will serve as mobile application programming lecture group project assignment

NewsApp

NewsApp is a modern news application for Android and iOS, providing live headlines and top stories from various categories and countries. It offers a seamless experience for users to stay updated with the latest news.

Features

• Live top headlines from over 50 countries.
• News categorization (Business, Entertainment, General, Health, Science, Sports, Technology).
• Dark and light mode for comfortable reading.
• Detailed news view with web integration for full articles.

Getting Started

These instructions will get you a copy of the project up and running on your local machine for development and testing purposes.

Prerequisites

• Flutter (latest version)
• Dart (latest version)
• Android Studio or Visual Studio Code

Installation

1. Clone the repository: git clone https://github.com/mubozk/FlutNews.git

2. Navigate to the project directory: cd FlutNews please open the folder in FlutNews as well cd flut_news

3. Get Flutter dependencies: flutter pub get

4. Run the application: flutter run

Usage

After launching the app, users can:

• Browse top headlines on the home screen.
• Select a news category to view related news.
• Toggle between dark and light themes.
• Read full news articles through in-app web views.

Contributing

Contributions are what make the open-source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

Contact

[email protected] Project Link: https://github.com/yourusername/NewsApp

Acknowledgements

• Flutter
• News API