Skip to content

Commit 1f9a482

Browse files
ItzNotABugItzNotABug
committed
feat: starter kit.
1 parent 4705d9b commit 1f9a482

File tree

208 files changed

+7497
-2
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

208 files changed

+7497
-2
lines changed

Diff for: ‎.gitignore

+45
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,45 @@
1+
# Miscellaneous
2+
*.class
3+
*.log
4+
*.pyc
5+
*.swp
6+
.DS_Store
7+
.atom/
8+
.build/
9+
.buildlog/
10+
.history
11+
.svn/
12+
.swiftpm/
13+
migrate_working_dir/
14+
15+
# IntelliJ related
16+
*.iml
17+
*.ipr
18+
*.iws
19+
.idea/
20+
21+
# The .vscode folder contains launch configuration and tasks you configure in
22+
# VS Code which you may wish to be included in version control, so this line
23+
# is commented out by default.
24+
.vscode/
25+
26+
# Flutter/Dart/Pub related
27+
**/doc/api/
28+
**/ios/Flutter/.last_build_id
29+
.dart_tool/
30+
.flutter-plugins
31+
.flutter-plugins-dependencies
32+
.pub-cache/
33+
.pub/
34+
/build/
35+
36+
# Symbolication related
37+
app.*.symbols
38+
39+
# Obfuscation related
40+
app.*.map.json
41+
42+
# Android Studio will place build artifacts here
43+
/android/app/debug
44+
/android/app/profile
45+
/android/app/release

Diff for: ‎.metadata

+45
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,45 @@
1+
# This file tracks properties of this Flutter project.
2+
# Used by Flutter tool to assess capabilities and perform upgrades etc.
3+
#
4+
# This file should be version controlled and should not be manually edited.
5+
6+
version:
7+
revision: "17025dd88227cd9532c33fa78f5250d548d87e9a"
8+
channel: "stable"
9+
10+
project_type: app
11+
12+
# Tracks metadata for the flutter migrate command
13+
migration:
14+
platforms:
15+
- platform: root
16+
create_revision: 17025dd88227cd9532c33fa78f5250d548d87e9a
17+
base_revision: 17025dd88227cd9532c33fa78f5250d548d87e9a
18+
- platform: android
19+
create_revision: 17025dd88227cd9532c33fa78f5250d548d87e9a
20+
base_revision: 17025dd88227cd9532c33fa78f5250d548d87e9a
21+
- platform: ios
22+
create_revision: 17025dd88227cd9532c33fa78f5250d548d87e9a
23+
base_revision: 17025dd88227cd9532c33fa78f5250d548d87e9a
24+
- platform: linux
25+
create_revision: 17025dd88227cd9532c33fa78f5250d548d87e9a
26+
base_revision: 17025dd88227cd9532c33fa78f5250d548d87e9a
27+
- platform: macos
28+
create_revision: 17025dd88227cd9532c33fa78f5250d548d87e9a
29+
base_revision: 17025dd88227cd9532c33fa78f5250d548d87e9a
30+
- platform: web
31+
create_revision: 17025dd88227cd9532c33fa78f5250d548d87e9a
32+
base_revision: 17025dd88227cd9532c33fa78f5250d548d87e9a
33+
- platform: windows
34+
create_revision: 17025dd88227cd9532c33fa78f5250d548d87e9a
35+
base_revision: 17025dd88227cd9532c33fa78f5250d548d87e9a
36+
37+
# User provided section
38+
39+
# List of Local paths (relative to this file) that should be
40+
# ignored by the migrate tool.
41+
#
42+
# Files that are not part of the templates will be ignored by default.
43+
unmanaged_files:
44+
- 'lib/main.dart'
45+
- 'ios/Runner.xcodeproj/project.pbxproj'

Diff for: ‎README.md

+50-2
Original file line numberDiff line numberDiff line change
@@ -1,2 +1,50 @@
1-
# starter-for-flutter
2-
Appwrite's starter kit for Flutter 💙
1+
# Flutter Starter Kit with Appwrite
2+
3+
Kickstart your Flutter development with this ready-to-use starter project integrated
4+
with [Appwrite](https://appwrite.io).
5+
6+
This guide will help you quickly set up, customize, and build your Flutter app.
7+
8+
---
9+
10+
## 🚀 Getting Started
11+
12+
### Clone the Project
13+
14+
Clone this repository to your local machine using Git or directly from `Android Studio`:
15+
16+
```bash
17+
git clone https://github.com/appwrite/starter-for-flutter
18+
```
19+
20+
Alternatively, open the repository URL in `Android Studio` to clone it directly.
21+
22+
---
23+
24+
## 🛠️ Development Guide
25+
26+
1. **Configure Appwrite**
27+
Navigate to `lib/data/repository/appwrite_repository.dart` and update the values to match your
28+
Appwrite project credentials.
29+
30+
2. **Customize as Needed**
31+
Modify the starter kit to suit your app's requirements. Adjust UI, features, or backend
32+
integrations as per your needs.
33+
34+
3. **Run the App**
35+
Select a target device (emulator or a connected physical device) in `Android Studio`, and
36+
click **Run** to start the app.
37+
38+
---
39+
40+
## 📦 Building for Production
41+
42+
Follow the official Flutter guide on deploying an app to
43+
production : https://docs.flutter.dev/deployment
44+
45+
---
46+
47+
## 💡 Additional Notes
48+
49+
- This starter project is designed to streamline your Android development with Appwrite.
50+
- Refer to the [Appwrite Documentation](https://appwrite.io/docs) for detailed integration guidance.

Diff for: ‎analysis_options.yaml

+28
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,28 @@
1+
# This file configures the analyzer, which statically analyzes Dart code to
2+
# check for errors, warnings, and lints.
3+
#
4+
# The issues identified by the analyzer are surfaced in the UI of Dart-enabled
5+
# IDEs (https://dart.dev/tools#ides-and-editors). The analyzer can also be
6+
# invoked from the command line by running `flutter analyze`.
7+
8+
# The following line activates a set of recommended lints for Flutter apps,
9+
# packages, and plugins designed to encourage good coding practices.
10+
include: package:flutter_lints/flutter.yaml
11+
12+
linter:
13+
# The lint rules applied to this project can be customized in the
14+
# section below to disable rules from the `package:flutter_lints/flutter.yaml`
15+
# included above or to enable additional rules. A list of all available lints
16+
# and their documentation is published at https://dart.dev/lints.
17+
#
18+
# Instead of disabling a lint rule for the entire project in the
19+
# section below, it can also be suppressed for a single line of code
20+
# or a specific dart file by using the `// ignore: name_of_lint` and
21+
# `// ignore_for_file: name_of_lint` syntax on the line or in the file
22+
# producing the lint.
23+
rules:
24+
# avoid_print: false # Uncomment to disable the `avoid_print` rule
25+
# prefer_single_quotes: true # Uncomment to enable the `prefer_single_quotes` rule
26+
27+
# Additional information about this file can be found at
28+
# https://dart.dev/guides/language/analysis-options

Diff for: ‎android/.gitignore

+13
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,13 @@
1+
gradle-wrapper.jar
2+
/.gradle
3+
/captures/
4+
/gradlew
5+
/gradlew.bat
6+
/local.properties
7+
GeneratedPluginRegistrant.java
8+
9+
# Remember to never publicly share your keystore.
10+
# See https://flutter.dev/to/reference-keystore
11+
key.properties
12+
**/*.keystore
13+
**/*.jks

Diff for: ‎android/app/build.gradle

+40
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,40 @@
1+
plugins {
2+
id "com.android.application"
3+
id "kotlin-android"
4+
id "dev.flutter.flutter-gradle-plugin"
5+
}
6+
7+
android {
8+
ndkVersion = "25.1.8937393"
9+
namespace = "io.appwrite.flutter"
10+
compileSdk = flutter.compileSdkVersion
11+
12+
compileOptions {
13+
sourceCompatibility = JavaVersion.VERSION_17
14+
targetCompatibility = JavaVersion.VERSION_17
15+
}
16+
17+
kotlinOptions {
18+
jvmTarget = JavaVersion.VERSION_17
19+
}
20+
21+
defaultConfig {
22+
applicationId = "io.appwrite.flutter"
23+
24+
minSdk = flutter.minSdkVersion
25+
targetSdk = flutter.targetSdkVersion
26+
27+
versionCode = flutter.versionCode
28+
versionName = flutter.versionName
29+
}
30+
31+
buildTypes {
32+
release {
33+
signingConfig = signingConfigs.debug
34+
}
35+
}
36+
}
37+
38+
flutter {
39+
source = "../.."
40+
}

Diff for: ‎android/app/src/main/AndroidManifest.xml

+42
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,42 @@
1+
<manifest xmlns:android="http://schemas.android.com/apk/res/android">
2+
3+
<uses-permission android:name="android.permission.INTERNET" />
4+
5+
<application
6+
android:name="${applicationName}"
7+
android:icon="@mipmap/ic_launcher"
8+
android:label="AppwriteStarterKit">
9+
<activity
10+
android:name=".MainActivity"
11+
android:configChanges="orientation|keyboardHidden|keyboard|screenSize|smallestScreenSize|locale|layoutDirection|fontScale|screenLayout|density|uiMode"
12+
android:exported="true"
13+
android:hardwareAccelerated="true"
14+
android:launchMode="singleTop"
15+
android:taskAffinity=""
16+
android:theme="@style/LaunchTheme"
17+
android:windowSoftInputMode="adjustResize">
18+
<!-- Specifies an Android theme to apply to this Activity as soon as
19+
the Android process has started. This theme is visible to the user
20+
while the Flutter UI initializes. After that, this theme continues
21+
to determine the Window background behind the Flutter UI. -->
22+
<meta-data
23+
android:name="io.flutter.embedding.android.NormalTheme"
24+
android:resource="@style/NormalTheme" />
25+
<intent-filter>
26+
<action android:name="android.intent.action.MAIN" />
27+
<category android:name="android.intent.category.LAUNCHER" />
28+
</intent-filter>
29+
</activity>
30+
<!-- Don't delete the meta-data below.
31+
This is used by the Flutter tool to generate GeneratedPluginRegistrant.java -->
32+
<meta-data
33+
android:name="flutterEmbedding"
34+
android:value="2" />
35+
</application>
36+
<queries>
37+
<intent>
38+
<action android:name="android.intent.action.PROCESS_TEXT" />
39+
<data android:mimeType="text/plain" />
40+
</intent>
41+
</queries>
42+
</manifest>

Diff for: ‎android/app/src/main/kotlin/io/appwrite/flutter/MainActivity.kt

+5
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,5 @@
1+
package io.appwrite.flutter
2+
3+
import io.flutter.embedding.android.FlutterActivity
4+
5+
class MainActivity: FlutterActivity()

Diff for: ‎android/app/src/main/res/drawable-hdpi/branding.png

7.59 KB
Loading

Diff for: ‎android/app/src/main/res/drawable-hdpi/splash.png

4.98 KB
Loading

Diff for: ‎android/app/src/main/res/drawable-mdpi/branding.png

5.24 KB
Loading

Diff for: ‎android/app/src/main/res/drawable-mdpi/splash.png

3.38 KB
Loading

Diff for: ‎android/app/src/main/res/drawable-night-hdpi/branding.png

7.76 KB
Loading

Diff for: ‎android/app/src/main/res/drawable-night-mdpi/branding.png

5.48 KB
Loading

Diff for: ‎android/app/src/main/res/drawable-night-v21/background.png

69 Bytes
Loading

Diff for: ‎android/app/src/main/res/drawable-night-v21/launch_background.xml

+12
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,12 @@
1+
<?xml version="1.0" encoding="utf-8"?>
2+
<layer-list xmlns:android="http://schemas.android.com/apk/res/android">
3+
<item>
4+
<bitmap android:gravity="fill" android:src="@drawable/background"/>
5+
</item>
6+
<item>
7+
<bitmap android:gravity="center" android:src="@drawable/splash"/>
8+
</item>
9+
<item android:bottom="24dp">
10+
<bitmap android:gravity="bottom" android:src="@drawable/branding"/>
11+
</item>
12+
</layer-list>

Diff for: ‎android/app/src/main/res/drawable-night-xhdpi/branding.png

8.65 KB
Loading

Diff for: ‎android/app/src/main/res/drawable-night-xxhdpi/branding.png

12.5 KB
Loading

Diff for: ‎android/app/src/main/res/drawable-night-xxxhdpi/branding.png

12.6 KB
Loading

Diff for: ‎android/app/src/main/res/drawable-night/background.png

69 Bytes
Loading

Diff for: ‎android/app/src/main/res/drawable-night/launch_background.xml

+12
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,12 @@
1+
<?xml version="1.0" encoding="utf-8"?>
2+
<layer-list xmlns:android="http://schemas.android.com/apk/res/android">
3+
<item>
4+
<bitmap android:gravity="fill" android:src="@drawable/background"/>
5+
</item>
6+
<item>
7+
<bitmap android:gravity="center" android:src="@drawable/splash"/>
8+
</item>
9+
<item android:bottom="24dp">
10+
<bitmap android:gravity="bottom" android:src="@drawable/branding"/>
11+
</item>
12+
</layer-list>

Diff for: ‎android/app/src/main/res/drawable-v21/background.png

69 Bytes
Loading

Diff for: ‎android/app/src/main/res/drawable-v21/launch_background.xml

+12
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,12 @@
1+
<?xml version="1.0" encoding="utf-8"?>
2+
<layer-list xmlns:android="http://schemas.android.com/apk/res/android">
3+
<item>
4+
<bitmap android:gravity="fill" android:src="@drawable/background"/>
5+
</item>
6+
<item>
7+
<bitmap android:gravity="center" android:src="@drawable/splash"/>
8+
</item>
9+
<item android:bottom="24dp">
10+
<bitmap android:gravity="bottom" android:src="@drawable/branding"/>
11+
</item>
12+
</layer-list>

Diff for: ‎android/app/src/main/res/drawable-xhdpi/branding.png

8.88 KB
Loading

Diff for: ‎android/app/src/main/res/drawable-xhdpi/splash.png

5.75 KB
Loading

Diff for: ‎android/app/src/main/res/drawable-xxhdpi/branding.png

12.8 KB
Loading

Diff for: ‎android/app/src/main/res/drawable-xxhdpi/splash.png

8.5 KB
Loading

Diff for: ‎android/app/src/main/res/drawable-xxxhdpi/branding.png

13.2 KB
Loading

Diff for: ‎android/app/src/main/res/drawable-xxxhdpi/splash.png

8.5 KB
Loading

Diff for: ‎android/app/src/main/res/drawable/background.png

69 Bytes
Loading

Diff for: ‎android/app/src/main/res/drawable/launch_background.xml

+12
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,12 @@
1+
<?xml version="1.0" encoding="utf-8"?>
2+
<layer-list xmlns:android="http://schemas.android.com/apk/res/android">
3+
<item>
4+
<bitmap android:gravity="fill" android:src="@drawable/background"/>
5+
</item>
6+
<item>
7+
<bitmap android:gravity="center" android:src="@drawable/splash"/>
8+
</item>
9+
<item android:bottom="24dp">
10+
<bitmap android:gravity="bottom" android:src="@drawable/branding"/>
11+
</item>
12+
</layer-list>

Diff for: ‎android/app/src/main/res/mipmap-hdpi/ic_launcher.png

2.14 KB
Loading

Diff for: ‎android/app/src/main/res/mipmap-mdpi/ic_launcher.png

1.48 KB
Loading

Diff for: ‎android/app/src/main/res/mipmap-xhdpi/ic_launcher.png

2.82 KB
Loading

Diff for: ‎android/app/src/main/res/mipmap-xxhdpi/ic_launcher.png

4.18 KB
Loading

Diff for: ‎android/app/src/main/res/mipmap-xxxhdpi/ic_launcher.png

5.82 KB
Loading

Diff for: ‎android/app/src/main/res/values-night-v31/styles.xml

+21
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,21 @@
1+
<?xml version="1.0" encoding="utf-8"?>
2+
<resources>
3+
<!-- Theme applied to the Android Window while the process is starting when the OS's Dark Mode setting is on -->
4+
<style name="LaunchTheme" parent="@android:style/Theme.Black.NoTitleBar">
5+
<item name="android:forceDarkAllowed">false</item>
6+
<item name="android:windowFullscreen">true</item>
7+
<item name="android:windowDrawsSystemBarBackgrounds">true</item>
8+
<item name="android:windowLayoutInDisplayCutoutMode">shortEdges</item>
9+
<item name="android:windowSplashScreenBackground">#19191D</item>
10+
<item name="android:windowSplashScreenIconBackgroundColor">#19191D</item>
11+
</style>
12+
<!-- Theme applied to the Android Window as soon as the process has started.
13+
This theme determines the color of the Android Window while your
14+
Flutter UI initializes, as well as behind your Flutter UI while its
15+
running.
16+
17+
This Theme is only used starting with V2 of Flutter's Android embedding. -->
18+
<style name="NormalTheme" parent="@android:style/Theme.Black.NoTitleBar">
19+
<item name="android:windowBackground">?android:colorBackground</item>
20+
</style>
21+
</resources>

Diff for: ‎android/app/src/main/res/values-night/styles.xml

+22
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,22 @@
1+
<?xml version="1.0" encoding="utf-8"?>
2+
<resources>
3+
<!-- Theme applied to the Android Window while the process is starting when the OS's Dark Mode setting is on -->
4+
<style name="LaunchTheme" parent="@android:style/Theme.Black.NoTitleBar">
5+
<!-- Show a splash screen on the activity. Automatically removed when
6+
the Flutter engine draws its first frame -->
7+
<item name="android:windowBackground">@drawable/launch_background</item>
8+
<item name="android:forceDarkAllowed">false</item>
9+
<item name="android:windowFullscreen">true</item>
10+
<item name="android:windowDrawsSystemBarBackgrounds">true</item>
11+
<item name="android:windowLayoutInDisplayCutoutMode">shortEdges</item>
12+
</style>
13+
<!-- Theme applied to the Android Window as soon as the process has started.
14+
This theme determines the color of the Android Window while your
15+
Flutter UI initializes, as well as behind your Flutter UI while its
16+
running.
17+
18+
This Theme is only used starting with V2 of Flutter's Android embedding. -->
19+
<style name="NormalTheme" parent="@android:style/Theme.Black.NoTitleBar">
20+
<item name="android:windowBackground">?android:colorBackground</item>
21+
</style>
22+
</resources>

Diff for: ‎android/app/src/main/res/values-v31/styles.xml

+21
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,21 @@
1+
<?xml version="1.0" encoding="utf-8"?>
2+
<resources>
3+
<!-- Theme applied to the Android Window while the process is starting when the OS's Dark Mode setting is off -->
4+
<style name="LaunchTheme" parent="@android:style/Theme.Light.NoTitleBar">
5+
<item name="android:forceDarkAllowed">false</item>
6+
<item name="android:windowFullscreen">true</item>
7+
<item name="android:windowDrawsSystemBarBackgrounds">true</item>
8+
<item name="android:windowLayoutInDisplayCutoutMode">shortEdges</item>
9+
<item name="android:windowSplashScreenBackground">#EDEDF0</item>
10+
<item name="android:windowSplashScreenIconBackgroundColor">#EDEDF0</item>
11+
</style>
12+
<!-- Theme applied to the Android Window as soon as the process has started.
13+
This theme determines the color of the Android Window while your
14+
Flutter UI initializes, as well as behind your Flutter UI while its
15+
running.
16+
17+
This Theme is only used starting with V2 of Flutter's Android embedding. -->
18+
<style name="NormalTheme" parent="@android:style/Theme.Light.NoTitleBar">
19+
<item name="android:windowBackground">?android:colorBackground</item>
20+
</style>
21+
</resources>

0 commit comments

Comments
 (0)