Amplify Flutter - Cat Image App
AWS Amplify Flutter launched it developer preview this week. For those who aren't aware I'm a massive Flutter lover and I've gone as far to even teach a course on it. Cross-platform mobile development has always been difficult when particular libraries aren't always available across Android and iOS. Flutter has been growing rapidly over the last couple years in this space and attracted enough attention that AWS have developed Amplify integration with Flutter.
If you aren't aware of what AWS Amplify is, just imagine a set of awesome tools and services all bundled up for ease of use. Incorporating the best and most secure practices from scratch.
In this tutorial we'll quickly explore how to bootstrap a simple Flutter app with AWS Amplify and build a Cat app for storing images of our fluffy friends.
For this guide there are three main components you will need.
- AWS Account - You will require a user account with credentials setup on your local system.
- Amplify CLI - Flutter version - Use this helpful guide provided on the Amplify docs site. Make sure you are using the Flutter version of the CLI
Note: To check whether you have the Flutter version of the Amplify CLI, run
amplify versionand confirm the version ends with
# If you don't want to follow the guide above # (though I HIGHLY recommend it) npm install -g @aws-amplify/cli@flutter-preview
Be sure that you have configured your Amplify CLI by running the following. You will be prompted with some information about default AWS region; select the location closest to you.
Note: If you already have AWS CLI credentials setup on your system you can skip this step, provided they contain the correct permissions for amplify deployments.
For the purpose of this guide we'll make use of the existing aws-amplify/amplify-flutter app and build on-top of it
Let us begin by cloning the project to the local system.
git clone email@example.com:aws-amplify/amplify-flutter.git
Since we're only interested in using the
example folder in the repository, go ahead and copy it out somewhere else (feel free to rename it also)
# Move example folder to something to match your project idea mv amplify-flutter/example/ amplify-flutter-cat-app cd amplify-flutter-cat-app
Next we need to initalize our Flutter app! Run the following from the project folder
It's fine to select the defaults for most options, however if you are using a different IDE then Visual Studio Code feel free to change that.
Once the Amplify app is initialized we next we need to add the amplify add-ons that our app will be using.
amplify add auth
All the settings here can be set to default. Feel free to select whatever method you would like for users to login with (this just means the username field).
amplify add storage
Select Content as the backend Database type. This just means that an S3 bucket will be used to store and serve static assets.
Be sure that you select the access permission of
read when asked as this will allow authenticated users to add and view images in the app.
amplify add analytics
For analytics make sure that Amazon Pinpoint is selected for this example.
Finally once all three add-ons have been configured individually push the amplify changes just made by running the following command.
Once the push is completed you should be greeted with the amazing ✅
The next step is to build the Flutter app and confirm that the AWS Amplify configuration works correctly. In this section we will also cover how to pull in Flutter dependencies and deploy it to an Android phone.
To begin with we must pull in all the Flutter dependencies required to build the project. This can be achieved by running the following command
flutter pub get
This command checks the
pubspec.yaml file for dependencies and pulls them down. In this case you can see that the amplify dev packages are listed
dependencies: flutter: sdk: flutter file_picker: ^1.8.0+1 amplify_core: ^0.0.1-dev.1 amplify_analytics_pinpoint: ^0.0.1-dev.1 amplify_auth_cognito: ^0.0.1-dev.1 amplify_storage_s3: ^0.0.1-dev.1
The next step requires an Android/iOS device (on MacOS) to be plugged into your computer to deploy to. Once connected run the following command to build and deploy the Flutter app to your phone
When the app launches you will be greeted with a login screen.
- Click Sign Up and fill our your details
- Retrieve your confirmation code via email and confirm your sign up
- Sign in with your authorized user
After signing in you can upload images by clicking the blue
+ in the bottom right of the screen and submitting a photo from your phone gallery
To clean up the project, you can run the following command from the project directory. Note that doing so will delete everything from the project.
AWS Amplify has always been a favourite of mine when it comes to developing apps fast and securely on AWS so pairing that with my favourite cross-platform framework, Flutter; I was always going to be bias towards the awesomeness.
I'm interested to hear what you think about the brand new support for Flutter in AWS Amplify, hit me up on Twitter @nathangloverAUS if you have any thoughts or questions.