Update readme
This commit is contained in:
Rumperuu
parent
203d375aa4
commit
9381458d79
114
README.md
114
README.md
|
|
@ -1,47 +1,101 @@
|
||||||
# LocalSpend Mobile App.
|
# LocalSpend (Mobile App.)
|
||||||
|
|
||||||
This repo. contains the mobile application for use with the LocalSpend system,
|
Looking to discover if the value of spending local can be measured, understood and shown.
|
||||||
using Flutter.
|
|
||||||
|
|
||||||
## Getting Started
|
This repository contains the mobile application for the LocalSpend system. See also:
|
||||||
|
|
||||||
Follow these steps to get the project up-and-running:
|
* the [Web application](https://github.com/Pear-Trading/Foodloop-Web); and
|
||||||
|
* the [server](https://github.com/Pear-Trading/Foodloop-Server).
|
||||||
|
|
||||||
1. Install [Flutter](https://flutter.dev/docs/get-started/install)
|
## Table of Contents
|
||||||
1. Set up [your editor](https://flutter.dev/docs/get-started/editor)
|
|
||||||
1. If this is your first Flutter project, install the [Flutter SDK](https://flutter.dev/docs/get-started/test-drive)
|
|
||||||
1. Add the line `flutter.sdk=⟨ path to Flutter SDK ⟩` to the file `androud/local.properties`
|
|
||||||
|
|
||||||
## Building
|
* [Tech Stack](#tech-stack)
|
||||||
|
* [Features](#features)
|
||||||
|
* [Installation](#installation)
|
||||||
|
* [Configuration](#configuration)
|
||||||
|
* [Usage](#usage)
|
||||||
|
* [Testing](#testing)
|
||||||
|
* [Code Formatting](#code-formatting)
|
||||||
|
* [Documentation](#documentation)
|
||||||
|
* [Acknowledgments](#acknowledgements)
|
||||||
|
* [License](#license)
|
||||||
|
* [Contacr](#contact)
|
||||||
|
|
||||||
To build an apk from dev, use:
|
## Technology Stack
|
||||||
```
|
|
||||||
flutter build apk -t lib/main_dev.dart
|
|
||||||
```
|
|
||||||
|
|
||||||
## Debugging
|
The mobile app. is written in [Dart](https://dart.dev/).
|
||||||
|
|
||||||
```
|
| Technology | Description | Link |
|
||||||
// debug
|
|-------------|---------------------------------|---------------------|
|
||||||
|
| Flutter | Cross-platform mobile framework | [Link][flutter] |
|
||||||
|
|
||||||
|
[flutter]: https://flutter.dev/
|
||||||
|
|
||||||
|
## Features
|
||||||
|
|
||||||
|
This mobile app. provides:
|
||||||
|
|
||||||
|
- user authentication; and
|
||||||
|
- transaction logging.
|
||||||
|
|
||||||
|
## Installation
|
||||||
|
|
||||||
|
1. Install [Flutter](https://flutter.dev/docs/get-started/install);
|
||||||
|
1. if this is your first Flutter project, install the [Flutter SDK](https://flutter.dev/docs/get-started/test-drive);
|
||||||
|
1. set up [your editor](https://flutter.dev/docs/get-started/editor):
|
||||||
|
- we recommend using [Android Studio](https://developer.android.com/studio).
|
||||||
|
1. add the line `flutter.sdk=⟨ path to Flutter SDK ⟩` to the file `android/local.properties`.
|
||||||
|
|
||||||
|
## Configuration
|
||||||
|
|
||||||
|
App. configuration settings are found in `pubspec.yaml`.
|
||||||
|
|
||||||
|
Build settings are found in the `android/` directory, in the `build.gradle`, `gradle.properties` and `settings.gradle` files.
|
||||||
|
|
||||||
|
## Usage
|
||||||
|
|
||||||
|
### Development
|
||||||
|
|
||||||
|
To activate debugging, add the following import statement:
|
||||||
|
|
||||||
|
```dart
|
||||||
import 'package:flutter/foundation.dart';
|
import 'package:flutter/foundation.dart';
|
||||||
debugPrint('$foo');
|
|
||||||
```
|
```
|
||||||
|
|
||||||
## Further Reading
|
After that, you can generate debugging output using `debugPrint()`.
|
||||||
|
|
||||||
A few resources to get you started if this is your first Flutter project:
|
### Production
|
||||||
|
|
||||||
- [Lab: Write your first Flutter app](https://flutter.io/docs/get-started/codelab)
|
Run `flutter build apk -t lib/main_dev.dart` to generate an APK file.
|
||||||
- [Cookbook: Useful Flutter samples](https://flutter.io/docs/cookbook)
|
|
||||||
|
|
||||||
For help getting started with Flutter, view our
|
## Testing
|
||||||
[online documentation](https://flutter.io/docs), which offers tutorials,
|
|
||||||
samples, guidance on mobile development, and a full API reference.
|
|
||||||
|
|
||||||
https://github.com/putraxor/flutter-login-ui
|
TODO
|
||||||
https://github.com/pbirdsall/medium_splash_tokenauth
|
|
||||||
|
## Code Formatting
|
||||||
|
|
||||||
|
TODO
|
||||||
|
|
||||||
|
## Documentation
|
||||||
|
|
||||||
|
TODO
|
||||||
|
|
||||||
|
## Acknowledgements
|
||||||
|
|
||||||
|
LocalLoop is the result of collaboration between the [Small Green Consultancy](http://www.smallgreenconsultancy.co.uk/), [Shadowcat Systems](https://shadow.cat/), [Independent Lancaster](http://www.independent-lancaster.co.uk/) and the [Ethical Small Traders Association](http://www.lancasteresta.org/).
|
||||||
|
|
||||||
|
## License
|
||||||
|
|
||||||
|
This project is released under the [MIT license](https://mit-license.org/).
|
||||||
|
|
||||||
|
## Contact
|
||||||
|
|
||||||
|
| Name | Link(s) |
|
||||||
|
|----------------|-------------------|
|
||||||
|
| Mark Keating | [Email][mkeating] |
|
||||||
|
| Michael Hallam | [Email][mhallam] |
|
||||||
|
|
||||||
|
[mkeating]: mailto:m.keating@shadowcat.co.uk
|
||||||
|
[mhallam]: mailto:info@lancasteresta.org
|
||||||
|
|
||||||
Related repos:
|
|
||||||
|
|
||||||
- [`Pear-Trading/FoodLoop-Web`](https://github.com/Pear-Trading/FoodLoop-Web)
|
|
||||||
- [`Pear-Trading/Foodloop-Server`](https://github.com/Pear-Trading/Foodloop-Server)
|
|
||||||
Reference in New Issue