An open API service indexing awesome lists of open source software.

https://github.com/aurelitec/hello_world_informed

📱 "I'm a physical device" or "I'm an emulator" - A Hello World Flutter app displaying Android info bits in a first-person style, via random facts or in a list. Simple black and white design.
https://github.com/aurelitec/hello_world_informed

android device-info flutter flutter-app helloworld helloworldapp random-facts

Last synced: 4 months ago
JSON representation

📱 "I'm a physical device" or "I'm an emulator" - A Hello World Flutter app displaying Android info bits in a first-person style, via random facts or in a list. Simple black and white design.

Awesome Lists containing this project

README

          

# Hello World Informed

[![Version badge](https://img.shields.io/github/v/tag/aurelitec/hello_world_informed?color=forestgreen&label=version)](https://github.com/aurelitec/hello_world_informed)
[![GitHub Code Size badge](https://img.shields.io/github/languages/code-size/aurelitec/hello_world_informed)](https://github.com/aurelitec/hello_world_informed)
[![Style badge](https://img.shields.io/badge/style-flutter__lints-4BC0F5.svg)](https://pub.dev/packages/flutter_lints)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow)](LICENSE)
[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-green)](https://github.com/aurelitec/hello_world_informed/pulls)

📱 "I'm a physical device" or "I'm an emulator" - Hello World Informed is a simple Hello World Flutter app that runs on Android. It displays "info bits" (short pieces of device data) in a first-person style. These info bits can be viewed randomly on the home screen, refreshed with a shuffle button, or browsed in a scrollable list. The app uses a clean and simple black and white theme.

Hello World Informed is yet another take on the classic "Hello, World!" program, a traditional first step in learning a new programming language or framework. While typical "Hello, World!" programs simply display text, this app expands on that concept by showing (some) device information in a more dynamic and interactive way. Being open-source, with well-commented code and examples of common mobile UI elements (AppBar, FAB, list views, navigation between two screens, etc.), it offers potential educational value for those learning Flutter development.

## Screenshots

In the spirit of a true "Hello World" app, Hello World Informed keeps things simple with just two screens and a clean black and white theme. Below are screenshots of the two simple screens: the home screen displaying a random info bit, and the list screen for browsing all info bits.

| Random info bit display | Browsing all info bits |
| ----------- | -------------------- |
| ![Hello World Informed home screen](repo-assets/hello-world-informed-home-screenshot.png) | ![Hello World Informed info bit list screen](repo-assets/hello-world-informed-info-bit-list-screenshot.png) |

## Getting Started

To run this project locally, you will need the Flutter SDK installed on your machine. If you don't have it already, follow the instructions on the [official Flutter website](https://docs.flutter.dev/get-started/install).

Once you have Flutter installed, follow these steps:

1. **Clone the repository:**

```bash
git clone https://github.com/aurelitec/hello_world_informed.git
cd hello_world_informed
```
2. **Install dependencies:**

```bash
flutter pub get
```

3. **Connect a device (or use an emulator):**

Make sure you have a physical Android device connected to your computer in developer mode, or have an Android emulator running.

4. **Run the app:**

```bash
flutter run
```

This command will build the app and install it on your connected device or emulator.

## Contributing

Even Hello World apps can benefit from code improvements. If you're a Flutter developer, or just learning Flutter, feel free to explore the code, suggest improvements, or even add new info bits!

To get started:

1. Fork the repository.
2. Create a new branch for your contribution.
3. Make your changes.
4. Submit a pull request.

## License

Hello World Informed is licensed under the [MIT license](LICENSE).