Acadify EDU ERP – School Management System (Website, Admin Panel & Student/Teacher App)

Mobile App

Configure, rebrand and build the Flutter app for students and teachers

Version: 1.2.0 (website, admin panel and app)
Stack: Laravel 12 · PHP 8.2+ · MySQL 8 / MariaDB 10.6+ · Flutter 3.44
License: Envato Market (Regular / Extended)
Author: BugBuild Lab · [email protected]

About the App

Main_Files/AppSourceCode is one Flutter project for Android and iOS. It connects to your Acadify website over the REST API (/api/v1), so install the website first. The app has no data of its own: accounts, classes, homework, marks and notices all come from your site.

Onboarding
Onboarding
Login
Login
Student home
Student home
Teacher home
Teacher home

One App for Students and Teachers

After login the app reads the account’s role and opens the matching experience. You build and publish one app.

RoleWhat the app shows
StudentDashboard, homework (view, submit with an attachment), class routine (and PDF), exam routine, assigned exams, mark sheet, online exams (take, submit, results), attendance (monthly and yearly), fees with receipt download, notices, subjects, teachers, library (search, issued books), transport, dormitory, events, ID card, notifications.
TeacherDashboard, my classes and student lists, take attendance (class teachers), homework (create, edit, grade), marks entry, exam schedule, timetable, leave, notices, notifications, profile.
Parent, admin, staffA friendly screen asking them to use the school website.

Teachers see only their own classes and subjects, exactly as in the teacher panel; assignments are made on the website (Teacher assignments).

Homework
Homework
Class routine
Class routine
Examinations
Examinations
Attendance
Attendance
Online exams
Online exams
Library
Library
Notifications
Notifications
Teacher: my classes
Teacher: my classes
Teacher: attendance
Teacher: attendance
Teacher: marks
Teacher: marks

Requirements

  • Flutter 3.44 (stable channel); the project allows Dart SDK >=3.4.4 <4.0.0.
  • Android Studio or VS Code with the Flutter plugin, and the Android SDK.
  • For iOS: a Mac with Xcode and CocoaPods. The project targets iOS 12.0 and later.
  • Your Acadify website installed and reachable over HTTPS, with JWT_SECRET set (php artisan jwt:secret).

Open and Run

cd AppSourceCode
flutter pub get
flutter run --dart-define=API_BASE_URL=https://your-domain.com/api/v1

Use a copy of the folder for your work, so you always have the original to compare with.

Connect the App to Your Site

The API address is in lib/utils/end_points.dart:

class EndPoints {
  static const String baseUrl = String.fromEnvironment(
    'API_BASE_URL',
    defaultValue: 'https://your-domain.com/api/v1',
  );

Either replace the defaultValue with your address, or leave it and pass the address at build time with --dart-define=API_BASE_URL=https://your-domain.com/api/v1. The address must end in /api/v1, without a trailing slash.

Use HTTPS. Android and iOS block plain http:// connections in release builds. For an Android emulator talking to a site on your own computer use http://10.0.2.2:8000/api/v1 in a debug build.

App Name, Package ID and Bundle ID

You must change the package ID before publishing. The project ships with the placeholder com.example.my_school (Android) and com.example.mySchool (iOS). Google Play and the App Store reject com.example IDs, and the ID cannot be changed after the first upload. Use your own reverse domain, for example com.yourschool.app.

Android
  1. In android/app/build.gradle.kts change both namespace and applicationId:
    android {
        namespace = "com.yourschool.app"
        ...
        defaultConfig {
            applicationId = "com.yourschool.app"
  2. Move android/app/src/main/kotlin/com/example/my_school/MainActivity.kt to the matching folder (for example kotlin/com/yourschool/app/) and change its first line to package com.yourschool.app.
  3. The app name is android:label="Acadify" in android/app/src/main/AndroidManifest.xml.
iOS
  1. Open ios/Runner.xcworkspace in Xcode, select the Runner target → Signing & Capabilities and set the Bundle Identifier (this changes PRODUCT_BUNDLE_IDENTIFIER in ios/Runner.xcodeproj/project.pbxproj).
  2. The app name is CFBundleDisplayName (and CFBundleName) in ios/Runner/Info.plist, set to “Acadify”.

The Dart package name my_school in pubspec.yaml is only used inside the code; you do not need to change it. The version is version: 1.2.0+2 in pubspec.yaml; raise the number after + for every store upload.

Icons, Splash Screen, Logo and Colour

Launcher icon

Replace assets/images/app_icon.png (square PNG, 1024 × 1024 recommended) and run:

dart run flutter_launcher_icons

The settings are in the flutter_launcher_icons: block of pubspec.yaml.

Splash screen

Replace assets/images/splash_icon.png, change color in the flutter_native_splash: block of pubspec.yaml if you like (default #0265F6), and run:

dart run flutter_native_splash:create
Logo inside the app

Replace assets/images/logo_light.png and assets/images/logo_dark.png (used on light and dark backgrounds).

Brand colour (automatic)

The app uses the accent colour the school picks in Website → Themes → Appearance on the website. It reads it from /api/v1/app/settings and remembers it on the device, so a new colour appears in the app without a new build. Without a colour it uses #0265F6.

Teal accent from the website
Teal accent from the website
Violet accent from the website
Violet accent from the website
Dark mode
Dark mode
Teacher, dark mode
Teacher, dark mode

Login, Languages and Notifications

  • Login with email and password, or with phone number and a one-time code. Forgot password sends a one-time code by email (needs mail settings) or SMS.
  • Theme: light, dark or follow the system, chosen in the profile menu.
  • Languages: the app downloads its languages and texts from your website (English, Bangla, Arabic, Spanish, French, Portuguese and any language you add). Arabic and other RTL languages mirror the layout. Edit the texts in Language → Edit phrases.
  • Notifications: the notification screen lists the user’s notifications from your site, marks unread ones with a dot and opens the related screen. The app does not use Firebase push notifications.
Phone login
Phone login
One-time code
One-time code
Arabic (RTL)
Arabic (RTL)
Bangla
Bangla

Demo Accounts

When the app is connected to a server in demo mode (APP_DEMO=true) the login screen shows Teacher and Student demo cards. On the live demo:

RoleEmailPassword
Student[email protected]12345678
Teacher[email protected]12345678

On your own server (demo mode off) the cards are hidden; sign in with real student and teacher accounts.

Android Signing

Out of the box, release builds are signed with the debug key so that flutter run --release works. Google Play needs your own key:

  1. Create a keystore (keep it and its passwords safe; you need them for every update):
    keytool -genkey -v -keystore ~/upload-keystore.jks -keyalg RSA -keysize 2048 -validity 10000 -alias upload
  2. Create android/key.properties (never share or commit it):
    storePassword=your-store-password
    keyPassword=your-key-password
    keyAlias=upload
    storeFile=/home/you/upload-keystore.jks
  3. In android/app/build.gradle.kts add at the very top:
    import java.util.Properties
    import java.io.FileInputStream
    
    val keystoreProperties = Properties()
    val keystorePropertiesFile = rootProject.file("key.properties")
    if (keystorePropertiesFile.exists()) {
        keystoreProperties.load(FileInputStream(keystorePropertiesFile))
    }
    and inside android { ... } add a release signing config and use it:
        signingConfigs {
            create("release") {
                keyAlias = keystoreProperties["keyAlias"] as String
                keyPassword = keystoreProperties["keyPassword"] as String
                storeFile = keystoreProperties["storeFile"]?.let { file(it) }
                storePassword = keystoreProperties["storePassword"] as String
            }
        }
        buildTypes {
            release {
                signingConfig = signingConfigs.getByName("release")
            }
        }
    (replace the existing buildTypes block that uses signingConfigs.getByName("debug")).

Build for Android

flutter build apk --release --dart-define=API_BASE_URL=https://your-domain.com/api/v1
flutter build appbundle --release --dart-define=API_BASE_URL=https://your-domain.com/api/v1

The APK is in build/app/outputs/flutter-apk/, the App Bundle (for Google Play) in build/app/outputs/bundle/release/. Leave out --dart-define if you changed the default in end_points.dart.

Build for iOS

flutter build ios --release --dart-define=API_BASE_URL=https://your-domain.com/api/v1
cd ios && pod install && cd ..

Open ios/Runner.xcworkspace in Xcode, choose your team under Signing & Capabilities, then Product → Archive and upload through the Organizer. You need an Apple Developer account.

Troubleshooting

ProblemFix
Cannot connect / login failsOpen https://your-domain.com/api/v1/app/settings in a browser: it must return JSON. Check the address ends in /api/v1, uses HTTPS, and JWT_SECRET is set on the server.
“Not supported in the mobile app” after loginThe account is a parent, admin or staff account. The app is for students and teachers.
A teacher sees no classesAssign subjects and class teachers on the website for the current academic year (Teacher assignments).
Wrong colourSet the accent colour in Website → Themes and reopen the app.
Build errors after changing the package IDThe package line in MainActivity.kt and its folder must match namespace. Run flutter clean and build again.
Old icon or splashRun the icon and splash commands again, uninstall the app from the device and reinstall.