Build Yourself / Contribution Guide
How to build the app on your own system, or how to contribute to the project
Last updated
Was this helpful?
How to build the app on your own system, or how to contribute to the project
Last updated
Was this helpful?
Install , following the guide for your OS all the way up to the "Test Drive" page
Clone the repository to your system
We recommend building off the development
branch! It has the more recent code that is more likely to build without errors.
Add a file named .env
to the root of the project directory. Inside it, place GIPHY_API_KEY = ""
. This is to prevent a build error.
Find android > app > build.gradle
(not to be confused with android > build.gradle
), and scroll down to signingConfig signingConfigs.release
at line 111. Change this to signingConfig signingConfigs.debug
.
In a terminal window at the root of the project directory, run flutter build apk --release --flavor prod
You may need to accept licenses and perform other tasks since you are building Flutter for the first time. The terminal output will guide you through this process.
The output APK file path will be given to you, simply transfer it to your phone and install it!
In /lib/repository/models/html
add a new file called giphy.dart
. Inside this, put only const GIPHY_API_KEY = "";
. If you have your own API key for GIPHY, you can place it inside the quotes, otherwise leave it as is.
In the terminal window at the root of the project directory, run flutter build web --web-renderer=canvaskit
. It will output the build files to build/web
to be hosted on your server.
Install NuGet package manager
Go to Visual Studio Installer -> Modify Build Tools -> Individual Components and install the latest Windows 10 SDK
Run the following commands:
Under construction...
Hey there! We're glad you want to contribute. We only ask for these three things:
Write clean code, and comment it!
Follow Flutter & Dart best practices
Avoid making large formatting changes to files, unless that is the goal of your PR. It makes it easier for us to review the changes this way.
Make sure you've completed Pre-Requisites.
Fork the repo, and then clone the fork to your system
Open the files in the IDE of your choice
Complete step 2 of Initial Steps
Make your changes
Run the app using flutter run
or the green play button at the top of your IDE
Test your changes
Commit and PR!
Make sure you don't commit your changes to comment out onContentCommit
.
The client apps have a lot of variables that need to be tested. For example, if you're making a UI change, please make sure it looks good in all the default themes, and all the skins as well.
If you wish to make a backend change, we suggest you consult with the main developers before writing code. This is so we can come up with a plan of attack and make sure we don't degrade existing functionality or create bugs.