ReadMe: goodViberations, built using AI Agent(s)

Introduction

The project sources can be found on GitHub: https://github.com/jplatipus/goodViberations

This is a README file for the goodViberations project. It uses HTML and not markup, txt, or any other format. HTML is nice, doesn't need any special software to view the contents either in raw or rendered form.

It also allows screenshots and many other assets (stylesheets) to be placed in the img folder to make the documentation more informative, and attractive.

This project is a simple Android application built with Kotlin, Jetpack Compose and Android's Gemini coding agent. I have no Kotlin experience; the last Android app I wrote was around 15 years ago, in Java.

The first step was to create this project on GitHub.
It was then cloned in Android Studio.
Android studio was used to create an android app, using the UI Navigation Activity template offered during the creation process; the folder selected for the project is this project's folder.

The next step was to run the app generated by Android Studio to make sure all is well. It is all well.

Running the default app

The test device (Android phone) is configured to run the app as follows:

• developer options are enabled (using the obscure tap the build number 7 times in the about phone settings activity).
• USB debugging is enabled, as a cable is always more reliable than wifi or any other wireless communications medium.

The app is run on the Android test device.
The app works.

Files

Once the barebones app runs in Android Studio's emulator, it has been established that the development environment has been correctly configured, and that a project has been created for the purpose of writing the app. At this point it is worth giving a quick description of the app.

goodVeberations is a password manager app. It is a data entry app, the implementation of the app uses activities (forms in conventional terms) to perform the common CRUD (Create, Read, Update, Delete). Initially no encryption is defined for the data storage and retrieval. During development, it is easier to leave this out. The design uses a separate data layer and specification. IN this way there is a single place where encryptiuon can be added when everything else has been developed and works.

Specification files are located in the doc folder.

• The UI specification is located in UIActivities.html.
• The functionality specification is located in Functionality.html.
• The data layer specification is located in DataLayer.html.
• A blog, blogOfThisProject.html is also located in the doc folder. The blog is used as a kind of diary of the progress of this project. References to git tags are given, where relevant, so that it is possible to get a snapshot of the project as it was at that time.

The specification files are designed to be readable by humans and Gemini. In doing so, the documentation is also used to generate the code by the agent.