feat: v0.3.0.0 — hashtags (visible on editor) + bolder colour accent + centred title + nav drawer + new version scheme

v0.3.0.0 bundles four user-facing features, the plan-compliance polish
that was deferred from v0.2, and a permanent change to how we name
releases going forward.

VERSION SCHEME (app/build.gradle.kts)
  - versionName = '0.3.0.0' (MAJOR.MINOR.MAINTENANCE.EMERGENCY)
  - versionCode = 5
  - New gradle taskGraph validator fails the build if versionName
    doesn't match ^\d+\.\d+\.\d+\.\d+$ — we can't accidentally
    regress the scheme.
  - History re-keyed across README, Plan §10, CONTRIBUTING.md.

HASHTAGS
  - value class Hashtag (domain/model) with normalise/parseOrNull
    helpers; pattern: ^[a-z0-9][a-z0-9._-]{0,30}$
  - data class HashtagUsage (name, noteCount, lastUsedAt)
  - sealed class NoteFilter { Home, Favorites, Untagged, ByTag(name) }
  - Note gains hashtags: List<String> (sorted ascending)
  - Repository:
      - new entities HashtagEntity (@Index on name) and
        NoteHashtagCrossRef (many-to-many junction)
      - new methods: observeFavorites / observeUntagged /
        observeNotesForHashtag / observeHashtagsByRecentUse /
        observeAllHashtags / searchHashtags / addHashtag / removeHashtag
      - search() now matches content OR hashtag-name (case-insensitive)
      - ObjectBox queries use explicit StringOrder + type annotations
        (kapt's stubs are finicky around Property<String> overloads)

UI
  - CenterAlignedTopAppBar on both list and editor screens
  - List:
      - Hamburger top-left opens a ModalNavigationDrawer (Home /
        Favorites / Untagged / divider / scrollable Recent tags)
      - Drawer selection drives a NoteFilter state held at root
      - Search bar visible only when filter == Home
      - NoteCard redesign — 14 dp vertical gradient stripe +
        tinted surface (12 % colour blend) + 10 dp corner chip
      - Empty-state copy is filter-aware
  - Editor:
      - Persistent hashtag chip row above the text field
      - Tag # icon in the top bar + '+ add' chip opens a ModalBottomSheet
      - Autocomplete suggestions live from repository.searchHashtags
      - '+ Create name' button when the typed value is valid + new
      - Snackbar 'Maximum 5 tags reached.' when the cap is hit
      - Reconciled on save via addHashtag / removeHashtag diff

DOCS
  - README v0.3.0.0 section + re-keyed changelog
  - Development Plan §10 history re-keyed (0.1.0.0 / 0.1.1.0 /
    0.2.0.0 / 0.2.0.1 / 0.3.0.0)
  - CONTRIBUTING.md release-process note updated for the new scheme

VERIFIED
  - ./gradlew assembleDebug assembleRelease both green
  - Debug 25.7 MB, release 19.8 MB (v2-signed)
  - versionCode=5, versionName='0.3.0.0'
  - No INTERNET permission
  - Validator regression: setting versionName='0.3' causes
    assembleDebug to fail with the new scheme error message
This commit is contained in:
Incido Developer committed 2026-08-15 02:02:53 +12:00
1 parent 84900838f7
commit d616ce3021
20 files changed
+1285 -251

No files matched your search

+32 -17
View File
@@ -1,6 +1,17 @@
// :app — Android application entry point. Hosts MainActivity and the
// application manifest, including the launcher icon and theme.
import java.io.FileInputStream
//
// Version scheme (v0.3.0.0 onwards):
// versionName = "MAJOR.MINOR.MAINTENANCE.EMERGENCY"
// - MAJOR: large breaking redesigns (rare in v0.x)
// - MINOR: normal feature releases
// - MAINTENANCE: bug fixes / refactors on a given MINOR
// - EMERGENCY: 0 in normal releases; non-zero only for hotfixes
// shipped out-of-band (e.g. v0.2.0.1 — search-icon fix)
// versionCode: monotonic int. Always +1 per release.
//
// The validator below fails the build if versionName doesn't match the
// required dotted format, so we can't regress the scheme by accident.
import java.util.Properties
plugins {
@@ -17,22 +28,13 @@ android {
applicationId = "org.incido.app"
minSdk = 26
targetSdk = 35
versionCode = 3
versionName = "0.2"
versionCode = 5
versionName = "0.3.0.0"
}
// --- Signing ---
//
// v0.2 introduces a real release signing config so `./gradlew
// assembleRelease` produces an installable APK out of the box. The
// keystore file itself is gitignored — see keystore/README.md for
// generation instructions and for the (deliberately weak) dev
// passwords baked into this build script. **Replace with a real
// production keystore before publishing.**
signingConfigs {
create("release") {
// Resolve paths relative to the project root so the same
// config works from both Android Studio and CLI.
val keystoreFilePath = rootProject.file("keystore/release.jks")
if (keystoreFilePath.exists()) {
storeFile = keystoreFilePath
@@ -40,9 +42,6 @@ android {
keyAlias = "incido"
keyPassword = "incido_dev_keystore"
}
// If the keystore doesn't exist, the release build will fail
// with a clear "Keystore file not set for signing config
// release" message — by design.
}
}
@@ -51,7 +50,7 @@ android {
isMinifyEnabled = false
}
release {
isMinifyEnabled = false // TODO(v0.3): enable R8
isMinifyEnabled = false // TODO(v0.3.0.0+): enable R8
signingConfig = signingConfigs.getByName("release")
}
}
@@ -81,7 +80,6 @@ dependencies {
implementation(libs.androidx.core.ktx)
implementation(libs.kotlinx.coroutines.android)
// Compose BOM keeps all Compose artefact versions aligned
val composeBom = platform(libs.composeBom)
implementation(composeBom)
@@ -89,3 +87,20 @@ dependencies {
implementation(libs.compose.ui)
implementation(libs.compose.material3)
}
// --- Version-name scheme validator ---
//
// MAJOR.MINOR.MAINTENANCE.EMERGENCY — exactly four dotted integers.
// Fails fast so we can't accidentally publish a "0.3" again.
val versionScheme = Regex("""^\d+\.\d+\.\d+\.\d+$""")
gradle.taskGraph.whenReady {
val vn = android.defaultConfig.versionName
if (vn != null && !versionScheme.matches(vn)) {
throw GradleException(
"app versionName = \"$vn\" doesn't match the required " +
"MAJOR.MINOR.MAINTENANCE.EMERGENCY scheme (e.g. 0.3.0.0). " +
"Update app/build.gradle.kts."
)
}
}