This is a log snapshot management solution used to save and share log snapshots within the development team. Supports iOS/Android/Web and utilizes Dart backend API (with client-server shared code). Logs stored in Firestore and Firebase Auth used to access some parts of the data.

By default, mock repositories are used. So just run the project to try it with mock data.

• QA engineer or someone from the team finds an error in the app
• Whether it is an error popup or just a suspicious behaviour there should always be a button to upload logs to the LogKeeper
• This button reads log file and makes POST request which saves the log on the server, analyzes it and returns a link to it
• Now a person has the link to the uploaded log which they can share to the Bug report or just post it to the chat.
  The link looks something like: https://[your_hosting_url]/#/details?id=[log_id]
  Link redirects to this log like this:\

Log Contents	Log Contents in Web view

All logs later can be found on the home screen which is accessible only for authorized users\

Auth Screen	Home Screen	Log Deletion Popup
Settings Screen	Upload Log Screen	Home Screen Drawer

This tool uses:

• Flutter Bloc
• Firebase Firestore & Firestore cache
• Firebase Auth
• Dart backend (with shelf and Firebase)
• shared Dart code project usage with Docker
• Firebase Flutter app hosting
• Conditional rendering with proviso
• Embed Web browser
• Themes and their dynamic switching, drawer, popups, fading edge scroll view, ModelBinding, Hive, streams, service locator getIt etc

Consists of the following parts:

• log_keep_back (an API to upload logs and to retrieve links to share them)
• log_keep (client part to view logs or upload them manually)
• log_keep_shared (code shared between other two projects)
• code to send logs to an API from your apps (an example for Unity C# is given below)

Folders structure is based on https://hub.docker.com/r/google/dart-runtime-base in order to use shared code in log_keep_shared both on the client and server sides.

• Create one at https://firebase.google.com/
• Add apps that you need (iOS/Android/Web)
• Enable Firestore and create empty collections ("projects" and "logs")

in log_keep:

• add google-services.json for Android
• add GoogleService-Info.plist for iOS
• add firebaseConfig.js near index.html which should contain code like this:

var firebaseConfig = {
    apiKey: "..",
    authDomain: "..",
    projectId: "..",
    storageBucket: ".",
    messagingSenderId: "..",
    appId: "..",
    measurementId: ".."
};

firebase.initializeApp(firebaseConfig);

Mock repositories used by default. When your Firebase account is ready please go to app.dart and uncomment Firebase repositories

firebaseApp = await Firebase.initializeApp();

getIt.registerSingleton<AuthRepository>(
    FirebaseAuthRepository(),
    signalsReady: true);

getIt.registerSingleton<LogsRepository>(
    FirestoreLogsRepository(FirebaseFirestore.instance),
    signalsReady: true);

• cd log_keep
• flutter build web
• init and login using Firebase CLI
• firebase deploy --only hosting

For a backend to run you need a Google Service Account https://cloud.google.com/iam/docs/service-accounts.

Service account credentials could be passed to log_keep_back via .env file:

• private_key_id
• client_email
• client_id
• private_key
• databaseParentPath="projects/[PROJECT_ID]/databases/(default)/documents"
• serverLogUrlFormat="https://[PROJECT_ID].web.app/#/details?id={0}"

Instructions on how to build & deploy server can also be found here https://hub.docker.com/r/google/dart-runtime-base

Backend has one API method - saving log and generating the link for its retrieval.

There are two versions of backend: dart & js (express).

Here are instructions for js version & AWS Lightsail:

• Create an instance of type Linux/Unix + Node (the cheapest one is fine)
• Connect to the instance
• Then run

cd stack
sudo mkdir apps
sudo mkdir keeper
sudo mkdir /opt/bitnami/apps/keeper/conf
sudo mkdir /opt/bitnami/apps/keeper/htdocs

sudo nano /opt/bitnami/apps/keeper/conf/httpd-prefix.conf

add: Include "/opt/bitnami/apps/keeper/conf/httpd-app.conf"

sudo nano /opt/bitnami/apps/keeper/conf/httpd-app.conf

add:

ProxyPass / http://127.0.0.1:3000/

ProxyPassReverse / http://127.0.0.1:3000/

sudo nano /opt/bitnami/apache2/conf/bitnami/bitnami-apps-prefix.conf

add: Include "/opt/bitnami/apps/keeper/conf/httpd-prefix.conf"

• zip, upload and unzip back_api to keeper (see instructions here) (to add write permissions use: chmod ugo+rwx keeper)

• then in keeper folder run

sudo /opt/bitnami/ctlscript.sh restart apache
npm install

To run server as a service use forever

• sudo npm install -g forever
• forever start app.js

Don't forget to attach static IP to your new instance.

• Null safety
• Get rid of project specific parsing code in some base classes. It is located in log_contents_bloc.dart. See mock_logs_repositories.dart for the example of log it expects.

• The Web browser forces all widgets above it to ignore all clicks on them. As a temporary solution in such cases, the browser becomes hidden.
• Firestore limits its entities to 2mb so this is the limitation for log files uploaded. The plan is to use Firebase Storage to keep logs there.
• Flutter Web text rendering performance seems to have some issues. This is a target for some R&D. For now Web browser has been added as a fallback log viewer.

Unity, C#:

var form = new WWWForm();

// Prepare log data
form.AddField("token", token);
form.AddField("title", title);
form.AddField("author", author);
form.AddField("project", project);
form.AddField("contents", contents); // the log contents

// Send
var uwr = UnityWebRequest.Post("your_url" + "/save", form);
yield return uwr.SendWebRequest();
if (uwr.isNetworkError || uwr.isHttpError)
{
    // error
    return;
}

// Read result
var raw = Encoding.UTF8.GetString(uwr.downloadHandler.data);
var id = JSON.Parse(raw)["body"]["id"].Value;
var urlFormat = JSON.Parse(raw)["body"]["url_format"].Value;

// Get the link to the log
var link = string.Format(urlFormat, id);
_clipboardService.SetText(link);
ShowNotifications("Report link copied to clipboard");

Feel free to report bugs, request new features or to contribute to this project!

See folder unfurl_api for a Slack App which unfurls LogKeeper links like that:

Setup instructions are similar to Monday Unfurl App