feat: v0.2 - polish, favourites, search, colours, checklists, signing
v0.2 bundles all four phases from the planning session into a single
shippable release. versionCode 2 -> 3, versionName 0.1.1 -> 0.2.
DOMAIN
- Add NoteColor enum (NONE / BLUE / GREEN / AMBER / RED / PURPLE).
- Note: isFavorite + color fields; checklistCounts / checklistSummary
helpers parsing '- [ ]' / '- [x]' lines.
- NoteRepository: new search(query) + setFavorite(id, value) methods.
DATA
- NoteEntity: additive @Index isFavorite + colorKey (Short).
- NoteRepositoryImpl: search uses ObjectBox 'contains' case-insensitive;
observeAll + search sort favourites-first then updatedAt DESC.
UI
- NoteListViewModel: debounced(150ms) query -> repository.search;
openSearch / closeSearch helpers; toggleFavorite.
- NoteListScreen: search bar in top app bar; star icon + 4dp colour
stripe per card; checklist summary line ('N open - M done').
- NoteEditorViewModel: toggleFavorite + setColor; initial-snapshot
fields captured on first non-null observeById for dirty detection.
- NoteEditorScreen: BackHandler + AlertDialog 'Discard changes?' on
unsaved edits; star toggle in top bar; LazyRow of colour swatches.
POLISH
- Discard-confirm dialog implements Development Plan §5.2.
- Real release signing config (signingConfigs.release pointing at the
dev keystore in keystore/); keystore/release.jks gitignored;
keystore/README.md documents generation & rotation.
- KMP migration deferred to v0.5 (tracked in plan §10).
COMMUNITY / GITEA
- .gitea/workflows/build.yml: assembleDebug on push & PR, APK as
artefact.
- CONTRIBUTING.md, CODE_OF_CONDUCT.md (Contributor Covenant v2.1),
.gitea/ISSUE_TEMPLATE/{bug_report,feature_request}.yml,
.gitea/PULL_REQUEST_TEMPLATE.md.
- README: v0.2 changelog + Gitea remote-setup instructions.
VERIFIED
- ./gradlew assembleDebug assembleRelease both green.
- Debug APK 25.6 MB, release 19.8 MB, both v0.2 / versionCode 3.
- apksigner verify: 'Verifies' / v2 scheme true.
- No INTERNET permission in either APK (privacy posture unchanged).
This commit is contained in:
1 parent
2215c3447b
commit
5e1b77bedf
21 files changed
+1242
-118
No files matched your search
@@ -6,20 +6,39 @@ Incido is a privacy-first, on-device note-taking application for Android.
|
||||
All data stays on your device by default — no accounts, no cloud, no
|
||||
trackers.
|
||||
|
||||
This repository contains the **v0.1 Minimum Viable Product**: a
|
||||
single-user, offline note app demonstrating the core architecture, data
|
||||
layer, and Compose UI shell that future versions will build on.
|
||||
This repository contains the **v0.2** release: a single-user, offline note
|
||||
app with favourites, full-text search, colour-coded notes, and inline
|
||||
checklists. The architecture is multi-module Android today and is
|
||||
structured so iOS / Desktop ports can happen later without UI rewrites.
|
||||
|
||||
**Current release:** v0.1.1 (patch — see [Changelog](#changelog) below).
|
||||
**Current release:** v0.2 (see [Changelog](#changelog) below).
|
||||
|
||||
---
|
||||
|
||||
## Features (v0.1)
|
||||
## Features
|
||||
|
||||
### v0.1.1 additions
|
||||
### v0.2 highlights
|
||||
|
||||
- **Favourites.** Tap the star icon on any card to pin it to the top of
|
||||
the list. (Replaces the §6.1 "Pinned Notes" item; renamed per
|
||||
maintainer request.)
|
||||
- **Full-text search.** Tap the search icon in the top app bar; the list
|
||||
filters live as you type. Backed by ObjectBox's `contains` query —
|
||||
case-insensitive, no extra dependencies.
|
||||
- **Color-coded notes.** Pick from six preset accent colours in the
|
||||
editor (none / blue / green / amber / red / purple). Each list card
|
||||
gets a 4dp vertical stripe on the left edge.
|
||||
- **Inline checklists.** Lines beginning with `- [ ]` or `- [x]` are
|
||||
parsed; the card preview shows the open/done counts (e.g.
|
||||
"2 open · 1 done"). No DB schema migration — the text stays plain.
|
||||
- **Discard-confirm dialog.** Closing the editor with unsaved changes
|
||||
now prompts "Discard changes?" with Discard / Keep-editing buttons.
|
||||
Applies to both the Back arrow and the hardware back gesture.
|
||||
|
||||
### v0.1.1 polish
|
||||
|
||||
- **Editor respects the soft keyboard.** With edge-to-edge enabled, the
|
||||
editor's `Scaffold` now unions `WindowInsets.systemBars` with
|
||||
editor's `Scaffold` unions `WindowInsets.systemBars` with
|
||||
`WindowInsets.ime`, so the text field automatically shrinks above the
|
||||
keyboard instead of being hidden behind it. `adjustResize` is also set
|
||||
on `MainActivity` as a pre-Android-15 fallback.
|
||||
@@ -30,18 +49,29 @@ layer, and Compose UI shell that future versions will build on.
|
||||
|
||||
### v0.1.0 (original MVP)
|
||||
|
||||
|
||||
- Create, edit, and delete plain-text notes
|
||||
- All notes persisted locally with [ObjectBox](https://objectbox.io/)
|
||||
- Material 3 UI with dynamic color (Android 12+) and dark/light themes
|
||||
- Fully offline — no `INTERNET` permission required
|
||||
- Multi-module Kotlin Multiplatform project (Android today, iOS/Desktop-ready for tomorrow)
|
||||
- ObjectBox-backed persistence ([objectbox.io](https://objectbox.io/))
|
||||
- Material 3 UI with dynamic color (Android 12+), dark/light follows system
|
||||
- Fully offline — no `INTERNET` permission
|
||||
- Multi-module Android project (Android today, iOS/Desktop-ready later)
|
||||
|
||||
---
|
||||
|
||||
## Roadmap
|
||||
|
||||
See `Incido Development Plan.txt` at the repository root for the
|
||||
canonical roadmap, including on-device ML, cross-platform ports,
|
||||
end-to-end sync, and security features.
|
||||
See [`Incido Development Plan.txt`](./Incido%20Development%20Plan.txt) at
|
||||
the repository root for the canonical backlog, including on-device ML,
|
||||
cross-platform ports, end-to-end sync, and security features.
|
||||
|
||||
---
|
||||
|
||||
## Changelog
|
||||
|
||||
| Version | Date | Highlights |
|
||||
|---------|------|------------|
|
||||
| 0.1 | 2026-08-14 | First MVP: list + editor, ObjectBox, Material 3 |
|
||||
| 0.1.1 | 2026-08-14 | Editor IME fix + title/body on list cards |
|
||||
| 0.2 | 2026-08-14 | Polish + favourites, search, colours, checklists, discard dialog, release signing |
|
||||
|
||||
---
|
||||
|
||||
@@ -62,13 +92,16 @@ their source code changes. This is intentional — it preserves the
|
||||
```
|
||||
incido/
|
||||
├── app/ # Android entry point (manifest, MainActivity)
|
||||
├── composeApp/ # Shared Compose UI (KMP commonMain + androidMain)
|
||||
├── composeApp/ # Shared Compose UI module
|
||||
├── core/
|
||||
│ ├── domain/ # Pure-Kotlin domain models & repository interfaces
|
||||
│ ├── domain/ # Pure-Kotlin domain models + repository interface
|
||||
│ └── data/ # ObjectBox-backed repository implementation
|
||||
├── gradle/ # Version catalog (libs.versions.toml)
|
||||
├── settings.gradle.kts
|
||||
└── build.gradle.kts
|
||||
├── gradle/ # Version catalog (libs.versions.toml) + wrapper
|
||||
├── keystore/ # Release signing (gitignored *.jks, README kept)
|
||||
├── .gitea/ # Gitea Actions workflow + issue/PR templates
|
||||
├── CONTRIBUTING.md
|
||||
├── CODE_OF_CONDUCT.md
|
||||
└── LICENSE
|
||||
```
|
||||
|
||||
---
|
||||
@@ -110,7 +143,18 @@ yes | $ANDROID_HOME/cmdline-tools/latest/bin/sdkmanager --licenses
|
||||
|
||||
The APK is written to `app/build/outputs/apk/debug/app-debug.apk`.
|
||||
|
||||
### 4. Install on a device
|
||||
### 4. (Optional) Build a signed release APK
|
||||
|
||||
```bash
|
||||
./gradlew assembleRelease
|
||||
```
|
||||
|
||||
Uses the dev keystore at `keystore/release.jks` — see
|
||||
[`keystore/README.md`](./keystore/README.md) for regeneration instructions.
|
||||
**Replace this keystore with a production key before any external
|
||||
distribution.**
|
||||
|
||||
### 5. Install on a device
|
||||
|
||||
```bash
|
||||
adb install -r app/build/outputs/apk/debug/app-debug.apk
|
||||
@@ -120,30 +164,51 @@ Or open the project in Android Studio and click **Run**.
|
||||
|
||||
---
|
||||
|
||||
## Manual Smoke Test (from the Development Plan §7.2)
|
||||
## Remote / Gitea Setup
|
||||
|
||||
When your self-hosted Gitea instance is online, register the remote and
|
||||
push the existing local commits:
|
||||
|
||||
```bash
|
||||
git remote add origin https://your-gitea.example.com/yourname/incido.git
|
||||
git push -u origin main
|
||||
git push origin --tags # if you have any local tags
|
||||
```
|
||||
|
||||
After the first push:
|
||||
|
||||
- `.gitea/workflows/build.yml` will automatically build the debug APK
|
||||
on every push to `main` and on every pull request. The APK is uploaded
|
||||
as a workflow artefact (`.gitea → Actions → build → Artifacts`).
|
||||
- `.gitea/ISSUE_TEMPLATE/bug_report.yml` and
|
||||
`feature_request.yml` will be picked up by Gitea when users open new
|
||||
issues.
|
||||
- `.gitea/PULL_REQUEST_TEMPLATE.md` will be auto-loaded on new PRs.
|
||||
|
||||
---
|
||||
|
||||
## Manual Smoke Test (Development Plan §7.2 + v0.2 additions)
|
||||
|
||||
```
|
||||
[ ] Launch app — see empty state message ("No notes yet. Tap + to start.")
|
||||
[ ] Tap FAB — editor opens, cursor in text field
|
||||
[ ] Type "Test note 1" — tap save — returns to list, "Test note 1" card visible
|
||||
[ ] Repeat for "Test note 2" and "Test note 3"
|
||||
[ ] Confirm all 3 notes visible on the list, newest at top
|
||||
[ ] Tap "Test note 2" card — editor opens with existing content
|
||||
[ ] Change to "Test note 2 (edited)" — tap save
|
||||
[ ] Confirm updated text appears on the card on the list
|
||||
[ ] Long-press "Test note 3" — delete option appears
|
||||
[ ] Confirm delete — note removed from the list
|
||||
[ ] Force-stop app from system settings
|
||||
[ ] Reopen app — "Test note 1" and "Test note 2 (edited)" both visible on the list
|
||||
[ ] Tap star on card 1 — it floats to the top
|
||||
[ ] Tap search icon — type "Test" — only matching card remains
|
||||
[ ] Close search — full list returns, favourite still on top
|
||||
[ ] Edit "Test note 2" → tap a colour swatch → save → card shows coloured stripe
|
||||
[ ] Create a note with "- [ ] milk\n- [x] eggs" → card preview shows "1 open · 1 done"
|
||||
[ ] Open a note → type extra content → tap Back → discard dialog appears
|
||||
[ ] Force-stop app from system settings, reopen → all notes + favourites still present
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Architecture (brief)
|
||||
|
||||
- **UI**: 100% Jetpack Compose / Compose Multiplatform in `composeApp/`.
|
||||
ViewModels expose immutable `StateFlow<UiState>` per screen; no
|
||||
third-party state management library.
|
||||
- **UI**: 100% Jetpack Compose in `composeApp/`. ViewModels expose
|
||||
immutable `StateFlow<UiState>` per screen; no third-party state
|
||||
management library.
|
||||
- **Domain**: Pure Kotlin interfaces in `core/domain/` — the only thing
|
||||
the UI sees.
|
||||
- **Data**: `core/data/` provides the ObjectBox implementation. ViewModels
|
||||
@@ -152,7 +217,6 @@ Or open the project in Android Studio and click **Run**.
|
||||
|
||||
## Contributing
|
||||
|
||||
Issues and PRs are welcome on the Gitea mirror. AGPL-3.0 means any
|
||||
contributions you submit must be under a compatible license. By
|
||||
submitting a contribution, you affirm you have the right to do so
|
||||
under these terms.
|
||||
See [`CONTRIBUTING.md`](./CONTRIBUTING.md). All participants are expected
|
||||
to follow [`CODE_OF_CONDUCT.md`](./CODE_OF_CONDUCT.md). By submitting a
|
||||
contribution you affirm you have the right to license it under AGPL-3.0.
|
||||
Reference in new issue
Block a user