M4.3's container seam, proven with the smallest ViewModel: * commonMain di/AppGraph.kt — the platform-neutral container face (noteRepository + settingsRepository) plus LocalAppGraph / requireAppGraph. Scope discipline per §9: only services BOTH platforms can honestly serve; Keystore/SecurityManager/BackupManager/CarnetImporter stay on the concrete AppContainer. * :core:settings + lifecycle-viewmodel enter commonMain (settings as api — AppGraph exposes it). Lifecycle coordinates are the SAME org.jetbrains.androidx.lifecycle 2.8.4 aliases androidMain already resolved since M4.1, so the §6.4 "verify the artifact set" question is answered GREEN for both targets and the state-holder fallback is NOT needed: DrawerViewModel moves with its androidx.lifecycle.* imports UNCHANGED (offline set keeps the androidx FQCNs). * DrawerViewModel.Factory(APPLICATION_KEY as IncidoApplication) → factory(graph: AppGraph). AppContainer implements AppGraph; IncidoApp provides LocalAppGraph at the root (same fallback chain it already used). Verification (one run): ./gradlew :composeApp:compileKotlinJvm assembleDebug → BUILD SUCCESSFUL (jvm target = first compile of a commonMain ViewModel on desktop deps)
Incido
Your notes. Your device. Your terms.
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.4.2.0 release: a single-user, offline
note app with hashtags, favourites, task lists, shopping lists with a
running total, voice notes with an in-app media player and downloadable
recordings, colour-coded notes with per-colour swatch filters,
auto-saved drafts, photo and file attachments, share-into from other
apps and the web, importing notes from third-party apps (Carnet /
QuickNote .zip exports) directly on-device, Trash (soft delete with
Restore / permanent delete / one-tap Empty Trash), at-rest
AES-256-GCM encryption with screenshot blocking, PIN / biometric lock,
encrypted backup and restore, and an exportable encryption key for
device migrations. The architecture is multi-module Android today and is
structured so iOS / Desktop ports can happen later without UI rewrites.
Current release: v0.4.2.0 (voice notes — a mic button turns any note into a recordable voice note with a built-in media player; recordings are compact Opus files (32 kbps, mono) stored with the note and downloadable to the device; the editor toolbar is reordered Photo · Voice · Attach · Tasks · Shopping list with the hashtag button flush right) — full release notes ship on its entry on the Releases page.
Back up before every update: from v0.4.2.0 onwards, every release asks the same of you — export a backup first (Settings → Backup & Restore → Export, plus your encryption key from Settings → Security if you use encryption) before installing a new version. Incido is offline by design and doesn't use Android's automatic backup, so a current backup is your only safety net for any update.
Upgrading from v0.3.8.0 or earlier? Releases are signed with a new CI key introduced in v0.3.8.1, so Android won't update an old install in place — it reports a signature conflict. Export a backup from Settings → Backup first (and your encryption key from Settings → Security if you use encryption), then uninstall and install fresh — Incido doesn't use Android's automatic backup, so uninstalling deletes your notes. Upgrading from v0.3.8.1 onwards is a normal in-place update.
Version scheme (from v0.3.0.0 onwards):
MAJOR.MINOR.MAINTENANCE.EMERGENCY— e.g.0.3.0.0.MAJOR.MINOR.MAINTENANCEare normal release numbers;EMERGENCYis non-zero only for hotfixes shipped out-of-band.versionCodeis a monotonic int and always +1 per release. An empty MAINTENANCE/EMERGENCY slot is written as0. The build refuses to compile ifversionNamedoesn't match this shape.
Roadmap
See Incido Development Plan.txt at
the repository root for the canonical backlog, including on-device ML,
cross-platform ports, end-to-end sync, and security features.
Changelog
Release notes now live on the Releases page: every Incido release entry
ships the full changelog for exactly that version — rendered in the
release description and attached beside the APKs as
Incido-<version>-changes.md (generated from PREVIOUS_HISTORY.md by the
release workflow).
→ Releases
· Previous release history (archive)
License
Incido is released under the GNU General Public License v3.0
(GPL-3.0). See LICENSE for the full text and
NOTICE for attributions.
Project Layout
incido/
├── app/ # Android entry point (manifest, MainActivity)
├── composeApp/ # Shared Compose UI module
├── core/
│ ├── domain/ # Pure-Kotlin domain models + repository interface
│ └── data/ # ObjectBox-backed repository implementation
├── gradle/ # Version catalog (libs.versions.toml) + wrapper
├── keystore/ # Release signing (gitignored *.jks, README kept)
├── scripts/ci/ # Release tooling (changelog extractor for the CI)
├── .gitea/ # Gitea Actions workflow + issue/PR templates
├── CONTRIBUTING.md
├── PREVIOUS_HISTORY.md # Archived user-facing release history
└── LICENSE
Build Instructions
Prerequisites
| Tool | Version | Notes |
|---|---|---|
| JDK | 17 (LTS) | java -version |
| Android SDK | API 35 + build-tools 35.0.0 | Install via sdkmanager |
| Gradle | 8.10.2 | Wrapped — ./gradlew downloads it on first run |
| Kotlin | 2.0.21 | Bundled with the Gradle build |
You do not need Android Studio. The CLI build works.
1. Configure local.properties
Create local.properties at the project root (already gitignored):
sdk.dir=/path/to/your/Android/sdk
On Linux this is typically ~/Android/sdk.
2. Accept SDK licenses (one-time)
yes | $ANDROID_HOME/cmdline-tools/latest/bin/sdkmanager --licenses
3. Build the debug APK
./gradlew assembleDebug
The APK is written to app/build/outputs/apk/debug/app-debug.apk.
4. (Optional) Build a signed release APK
./gradlew assembleRelease
Uses the dev keystore at keystore/release.jks — see
keystore/README.md for regeneration instructions.
Replace this keystore with a production key before any external
distribution.
The build will fail if versionName doesn't match
^\d+\.\d+\.\d+\.\d+$ (the new scheme). Update app/build.gradle.kts
to fix.
5. Install on a device
adb install -r app/build/outputs/apk/debug/app-debug.apk
Or open the project in Android Studio and click Run.
Remote / Gitea Setup
When your self-hosted Gitea instance is online, register the remote and push the existing local commits:
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.ymlwill automatically build the debug APK on every push tomainand on every pull request. The APK is uploaded as a workflow artefact (.gitea → Actions → build → Artifacts)..gitea/ISSUE_TEMPLATE/bug_report.ymlandfeature_request.ymlwill be picked up by Gitea when users open new issues..gitea/PULL_REQUEST_TEMPLATE.mdwill be auto-loaded on new PRs.
Manual Smoke Test (Development Plan §7.2 + v0.3.0.0 additions)
[ ] Launch app — "Incido" title centred, hamburger top-left
[ ] Tap hamburger → drawer slides in with Home / Favorites / colour-swatch strip (Blue·Green·Amber·Red·Purple) / Drafts / Untagged / Trash / Settings + divider + Recent tags
[ ] Tap "Favorites" → list shows only starred notes
[ ] Tap "Untagged" → list shows only notes with zero hashtags
[ ] Tap a colour swatch (e.g. Blue) → list shows only ACTIVE notes of that colour; untagged ones appear, trashed ones never; search narrows within the colour; tapping the selected swatch again returns to Home
[ ] Start a new note, type, then back out without saving → it lands under "Drafts"; an untitled draft is titled "Task List — (draft)" / "Shopping List — (draft)"; reopening it restores the content; saving it moves it to Home
[ ] Save a note (new or draft) → it appears on Home and NOT in Drafts — saving exits draft mode for good (v0.4.1.1 regression)
[ ] Shopping list: press Enter in a row's Price field → a fresh row appears below with the cursor in its Product field, not back in the Title (v0.4.1.1 fix)
[ ] Tap the mic button in a note's bottom toolbar → grant microphone access → a recording card appears above the text field; tap it, record, stop → a media player shows with play/pause, seek and elapsed/total time (v0.4.2.0)
[ ] Voice note: tap the download button on the player → the recording lands in the system Downloads folder; the card also appears in the attachment strip; converting the note back to text keeps the recording (v0.4.2.0)
[ ] Tap a recent hashtag → list filters to that tag
[ ] Tap "Trash" → list shows only soft-deleted notes
[ ] Delete a note → it disappears from Home/search/tag/Favorites and appears in Trash
[ ] Trash card overflow → "Restore" returns the note; "Delete permanently" destroys it
[ ] Trash holds notes → "Empty Trash" (∞-forever icon) appears in the top bar → confirm dialog → everything in Trash is permanently deleted
[ ] Tap "Home" → back to all active notes
[ ] Open a note → chip row above text field shows current tags (empty placeholder if none)
[ ] Tap "#" icon → sheet opens, type "wo" → suggestions filter
[ ] Add a new tag → chip appears, counter goes from N/5 to (N+1)/5
[ ] Tap chip ✕ → removed
[ ] Add 5 tags, attempt 6th → Snackbar "Maximum 5 tags reached"
[ ] Force-stop + reopen → all notes + hashtags + favourites + colours persist
Architecture (brief)
- UI: 100% Jetpack Compose in
composeApp/. ViewModels expose immutableStateFlow<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 depend on the interface, so the data layer can be swapped (e.g., for tests) without touching UI code.
Contributing
See CONTRIBUTING.md. By submitting a
contribution you affirm you have the right to license it under GPL-3.0.