Go to file

Hillel Coren 14b829b065 Tests		2021-05-03 17:00:20 +03:00
.github/workflows	Sentry	2021-04-29 17:07:51 +03:00
android	FOSS changes	2021-02-28 21:42:15 +02:00
assets/images	Add card meta data	2020-08-16 18:54:45 +03:00
fastlane/metadata/android/en-US	Update title	2020-12-16 09:20:22 +02:00
ios	ios build	2021-01-31 16:55:14 +02:00
lib	Tests	2021-05-03 16:47:25 +03:00
linux	Build	2021-03-11 17:13:45 +02:00
macos	Update macOS image	2021-02-28 14:29:57 +02:00
samples	Add scrollbars	2021-03-09 21:06:06 +02:00
stubs	Don't show edit as multiselect action	2021-05-02 12:46:29 +03:00
test	Update Flutter version	2021-02-15 10:10:18 +02:00
test_driver	Tests	2021-05-03 17:00:20 +03:00
web	Update web manifest	2021-03-18 23:38:26 +02:00
windows	Is large changes	2021-01-27 12:41:17 +02:00
.gitignore	PDF support	2019-12-26 21:25:45 +02:00
.metadata	…
LICENSE.txt	Update copyright year	2019-05-28 23:28:32 +03:00
README.md	Update readme	2021-04-14 13:56:39 +03:00
analysis_options.yaml	Hide Dart UI error	2020-09-03 20:37:56 +03:00
codemagic.yaml	Build	2021-03-11 16:55:20 +02:00
invoiceninja.iml	iOS app	2018-09-02 14:46:29 +03:00
invoiceninja_android.iml	…
pubspec.foss.yaml	Tests	2021-05-03 15:35:25 +03:00
pubspec.lock	Clients Tests	2021-05-02 22:41:05 +01:00
pubspec.yaml	Clients Tests	2021-05-02 22:41:05 +01:00
run_all_it_tests.sh	Combine all IT tests to one suite so as not to open and close the app between them.	2019-06-13 23:00:09 +03:00
starter.sh	Models	2021-03-24 16:38:57 +02:00

README.md

Invoice Ninja

Client app for the Invoice Ninja web app.

Google Play Store: v4 | v5
Apple App Store: v4 | v5

Dashboard View Invoice List Invoice New Invoice

Setting up the app

Initialize the config file

cp lib/.env.dart.example lib/.env.dart
Support running the code unsigned on Android

cp android/app/build.gradle.dev android/app/build.gradle
Run the app

flutter run

Note: if you don't have an Invoice Ninja backend setup you can test the app with these credentials:

Email: demo@invoiceninja.com
Password: Password0
URL: demo.invoiceninja.com

Steps to remove non-FOSS code

cp android/build.gradle.foss android/build.gradle
cp lib/utils/oauth.dart.foss lib/utils/oauth.dart
cp lib/ui/app/upgrade_dialog.dart.foss lib/ui/app/upgrade_dialog.dart
cp android/app/src/main/AndroidManifest.foss.xml android/app/src/main/AndroidManifest.xml
cp pubspec.foss.yaml pubspec.yaml 
rm pubspec.lock

Application Architecture

The application was created using the Flutter Redux Starter.

The architecture is based off these two projects:

Redux Sample - Brian Egan
inKino - Iiro Krankka

Blog Posts

Code generation

Run flutter packages pub run build_runner build --delete-conflicting-outputs to regenerate the model files. It will also remove the old generated files so conflicts are avoided..

Tests

Run flutter drive --target=test_driver/all_it.dart to run the tests

Code Signing

Run cp android/app/build.gradle.prod android/app/build.gradle to support running the code signed
Run cp android/key.properties.example android/key.properties to create the keys file
Run keytool -genkey -v -keystore key.jks -keyalg RSA -keysize 2048 -validity 10000 -alias invoiceninja to generate a key to be able to sign the android application.
Update android/key.properties according to the parameters you entered in previous command when you generated the key
Open a new Firebase project from your console. Firebase is used for authentication.
- Inside the project go to Authentication and enable at least one method.
- After go to add a new Android application. For the package name add com.invoiceninja.flutter
- Press "Register App" button.
- Download "google-services.json" and put it in android/app directory.

Credits

https://github.com/invoiceninja/invoiceninja#credits

Contributions

We gladly accept contributions! If you'd like to get involved with development please join our Slack group.