thaivtuberranking-frontend

A Flutter Web client application for Thai VTubers Directory website.

Setup

• See Documentation on Flutter site https://flutter.dev/docs/get-started/web

Local Command

See Makefile. Run make help to see the available commands.

Run make run to start the application locally.

API Document

See https://github.com/chuymaster/thaivtuberranking-docs

Localization

Use L10n helper class to localize strings. Do not use hard-coded strings.

Translation Sheet

Automated Deployment

• Auto trigger deploy to Netlify production site when production branch is updated. Host: https://vtuber.chuysan.com/#/
• Auto trigger deploy to Netlify QA site when main branch is updated. Host: https://vtuber-qa-chuysan.netlify.app/#/

Branch Strategy

• Use only main branch without long-live feature branch. (GitHub Flow)
• PR will be generated automatically by GitHub action. Merge it to promote to production when ready.

Unit Tests

This project use mockito to generate mock classes.

http.Client mock is already generated but if you need to generate new mock class, read the document, add @GenerateMocks annotation then run make build-mock to generate.

See video_ranking_repository.dart and video_ranking_repository_test.dart for example of API stub implementation.

Run flutter test to test all cases.

Netlify Build Command

Build commands that run when the branch is updated are listed below.

• QA (Staging) Environment

if cd flutter; then git fetch --tags && git checkout 3.27.1 && git pull; cd ..; else git clone https://github.com/flutter/flutter.git && cd flutter && git checkout 3.27.1 && cd ..; fi && flutter/bin/flutter channel stable && flutter/bin/flutter upgrade && flutter/bin/flutter config --enable-web && flutter/bin/flutter build web --release --dart-define=DEPLOY_ENVIRONMENT=Qa --web-renderer html

• Production Environment

if cd flutter; then git fetch --tags && git checkout 3.27.1 && git pull; cd ..; else git clone https://github.com/flutter/flutter.git && cd flutter && git checkout 3.27.1 && cd ..; fi && flutter/bin/flutter channel stable && flutter/bin/flutter upgrade && flutter/bin/flutter config --enable-web && flutter/bin/flutter build web --release --dart-define=DEPLOY_ENVIRONMENT=Production --web-renderer html

Contributing

I am still learning how to develop in Flutter. Feel free to raise an issue, create a pull request or contact me at @chuymaster 😄