NewsFlash is a modern and user-centric news application developed using Flutter. It is crafted to deliver an enhanced, seamless, and engaging news reading experience.
- Breaking News Carousel: View the latest top headlines in a visually appealing carousel.
- Category-Based News: Browse news articles based on different categories like Politics, Sports, Technology, and more.
- Search Functionality: Search for news articles by keywords or categories.
- Random Category Suggestions: Get random category suggestions in the search bar for a diverse news intake.
- Dark Theme with Vibrant Accents: Enjoy a modern UI with a dark theme and vibrant cyan/yellow accents for a sleek look.
This project is a starting point for a Flutter application. Follow these instructions to get a copy of the project up and running on your local machine for development and testing purposes.
-
Clone the repository:
git clone https://github.com/your-username/newsflash.git cd newsflash -
Install dependencies:
flutter pub get
-
Run the app:
flutter run
The project is structured as follows:
lib/
├── main.dart
├── home.dart
├── category.dart
├── model.dart
├── newsView.dart
└── ... (other files and folders)
main.dart: Entry point of the application.home.dart: Contains the home screen of the application.category.dart: Manages the category-based news screen.model.dart: Contains the data models used in the app.newsView.dart: Displays individual news articles.
Contributions are welcome! Please follow these steps to contribute:
- Fork the repository
- Create your feature branch (
git checkout -b feature/new-feature) - Commit your changes (
git commit -am 'Add new feature') - Push to the branch (
git push origin feature/new-feature) - Create a new Pull Request
A few resources to get you started if this is your first Flutter project:
- Lab: Write your first Flutter app
- Cookbook: Useful Flutter samples
- Online Documentation: Tutorials, samples, guidance on mobile development, and a full API reference.