Fred's Roadtrip Storyteller

Listen to historical markers as you travel - Learn about local history as you drive.

KMP (Kotlin Multi-Platform) Compose-based Proof-of-concept experimental app using Google Maps for iOS and Android.
Pure Kotlin App using SHARED core and SHARED Compose based UI, running in native Kotlin.

YouTube series following the development of the app:

YouTube Video Views

Assets

Wiki: Fred's Roadtrip Storyteller Wiki
Link to Marketing site source: https://github.com/realityexpander/FredsRoadtripStorytellerWebsite
Link to Marketing Site: https://FredsRoadtripStoryteller.com

Screen Shots

Android Screenshots

iOS Screenshots

note: screenshots may differ slightly from current version

External Locations for Promoting Project

https://medium.com/@chrisathanas/
https://www.youtube.com/@ChrisAthanas
Join the KMP Developers Group:
- Twitter/X: https://twitter.com/i/communities/1739883885658607808
- LinkedIn: https://www.linkedin.com/groups/14367209
- FaceBook: https://www.facebook.com/groups/913147236893976
Support email:
- info@fredsroadtripstoryteller.com
- Email forwarding service (Free): https://app.improvmx.com/
- Hostinger hosting dashboard: https://hpanel.hostinger.com/ realityexpanderdev acct

Application Architecture

<img src="raw_assets/Support_Documents/App_architecture.png" width="800">

Developer notes

INSTALLATION

Secrets Files
- Check the *.example files for proper placement
- Must create AppSecrets.plist from within Xcode - in password vault, for google maps account ID's.
- Can get google-services.json from Google Cloud Console for google maps account ID's.
  - Get a Google Maps API key
Add to local.properties file located in the root directory (create if it doesn't exist):
- MAPS_API_KEY=YOUR_KEY where YOUR_KEY is your key from previous step;
- sdk.dir=YOUR_SDK_PATH where YOUR_SDK_PATH is a path to Android SDK in your system.
From root dir, must run ./gradlew :shared:generateDummyFramework.
Must run pod update then pod install in the iosApp folder.
Must build the Android app before running the iOS app.
Open project in IntelliJ IDEA or Android Studio and run the androidApp configuration.
Note: There are many spurious warning messages from the AS IDE and pop-up warnings.
- It seems these can be safely ignored. (I assume they will address these issues in upcoming releases)

Source: (Code snapshot taken 10/8/23) https://github.com/JetBrains/compose-multiplatform/tree/master/examples/cocoapods-ios-example

Latest commit Ran & Built with:

Android Studio Koala | 2023.3.2 Canary 2
Build #AI-233.14475.28.2332.11606850, built on March 21, 2024
Runtime version: 17.0.10+0-17.0.10b1087.21-11572160 aarch64
VM: OpenJDK 64-Bit Server VM by JetBrains s.r.o.
macOS 14.4
GC: G1 Young Generation, G1 Old Generation
Memory: 4096M
Cores: 10
Metal Rendering is ON
Registry:
ide.tooltip.initialDelay=812
ide.browser.jcef.gpu.disable=true
debugger.new.tool.window.layout=true
analyze.exceptions.on.the.fly=true
ide.experimental.ui=true
Non-Bundled Plugins:
com.c5inco.modifiers (1.0.15)
dev.j-a.swift (0.21.0.336-233)
wu.seal.tool.jsontokotlin (3.7.4)
idea.plugin.protoeditor (233.13135.65)
com.wakatime.intellij.plugin (14.3.11)
com.github.airsaid.androidlocalize (3.0.0)
DBN (3.4.3073.0)
net.seesharpsoft.intellij.plugins.csv (3.3.0-233)
com.jetbrains.kmm (0.8.2(233)-8)
com.squareup.sqldelight (2.0.1)
com.developerphil.adbidea (1.6.15)
org.jetbrains.compose.desktop.ide (1.6.1)
by.overpass.svg-to-compose-intellij (0.14)
com.github.copilot (1.5.0.5148)
mobi.hsz.idea.gitignore (4.5.2)
com.abeade.plugin.figma.import (1.0.8)

Code style

https://github.com/realityexpander/FredsRoadtripStoryteller/blob/main/raw_assets/CodeStyle.md

KMP Stuff

KMP Jetbrains Wizard (basic)
- https://kmp.jetbrains.com/#newProject
KMP Wizard
- https://terrakok.github.io/Compose-Multiplatform-Wizard/
All kinds of libraries
- https://github.com/terrakok/kmp-awesome
Settings
- https://github.com/russhwolf/multiplatform-settings
Storage (Store5)
https://github.com/MobileNativeFoundation/Store
Location KMM implementation concept
- https://github.com/line/abc-kmm-location
kSoup - HTML parser for scraping web pages
- This thing is a hack and a half way of scraping, but until jSoup is ported, its what we got. -https://github.com/MohamedRejeb/ksoup
Painter resources
- https://github.com/JetBrains/compose-multiplatform/blob/master/tutorials/Image_And_Icons_Manipulations/README.md
Material Design 3
https://material.io/blog/material-3-compose-1-1
Drawers
https://developer.android.com/jetpack/compose/components/drawer
WebView
https://github.com/KevinnZou/compose-webview-multiplatform/blob/main/sample/shared/src/commonMain/kotlin/com/kevinnzou/sample/BasicWebViewSample.kt
Screen Orientation
https://youtrack.jetbrains.com/issue/KT-58292
https://

FredsRoadtripStoryteller

Install / Use

README