Go to file
Hillel Coren 3b3b4e5879 Correct tests/build 2021-08-11 18:37:40 +03:00
.github/workflows Correct tests/build 2021-08-11 18:37:40 +03:00
android Changes for Google sign in 2021-08-10 09:20:32 +03:00
assets/images Change to base64 password header 2021-07-23 18:15:32 +03:00
fastlane/metadata/android/en-US Update title 2021-05-30 18:54:12 +03:00
ios Update icon 2021-07-12 20:20:18 +03:00
lib Update Flutter version 2021-08-10 22:15:01 +03:00
linux Update Flutter 2021-08-09 21:18:03 +03:00
macos Update macOS image 2021-02-28 14:29:57 +02:00
samples Clean up code warnings 2021-05-24 22:11:39 +03:00
stubs Persist table sorting 2021-06-29 20:31:06 +03:00
test
test_driver Tests 2021-05-05 07:31:02 +03:00
web Live PDF 2021-07-30 00:18:23 +03:00
windows Update Flutter 2021-08-09 21:18:03 +03:00
.gitignore
.metadata
LICENSE.txt Revert license change 2021-07-07 15:48:28 +03:00
README.md Update iOS link 2021-07-21 10:45:04 +03:00
analysis_options.yaml
codemagic.yaml Build 2021-03-11 16:55:20 +02:00
invoiceninja.iml
invoiceninja_android.iml
pubspec.foss.yaml Correct tests/build 2021-08-11 18:37:40 +03:00
pubspec.lock Re-enable tests 2021-08-10 11:43:26 +03:00
pubspec.yaml Correct tests/build 2021-08-11 18:37:40 +03:00
run_all_it_tests.sh
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:

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.