Incido Developer 1d97376aef
dev / Build debug APK (push) Successful in 47s
release / Build & attach release APK (push) Successful in 1m20s
fix: v0.4.1.1 — saved notes leave Drafts; Enter adds row in price box
Two editor regressions shipped in v0.4.1.0, both fixed here:

- Saving a note published it but left UiState.existing.isDraft = true,
  so the editor's dispose-time flushDraft() re-persisted the note as a
  draft and it reappeared under Drafts. The save path now adopts the
  published row into state (isDraft = false, current hashtags kept),
  letting persistDraftNow()'s already-published guard make that flush
  a no-op; saved notes stay on Home.
- Enter on a shopping-list Price field had no keyboard handler, so the
  bare ImeAction.Next fell through to system focus traversal and — the
  price being the row's last field inside the LazyColumn — wrapped the
  cursor back to the Title. The field now wires
  KeyboardActions(onNext = onAddAfter) like the Product field: Enter
  adds a fresh row with the cursor in its Product box.

Version lockstep per §11.1: versionCode 37, versionName 0.4.1.1,
APP_VERSION, README intro + current-release line + smoke-test
regression steps, PREVIOUS_HISTORY.md section, ReleaseNotes.RECENT
(v0.3.8.1 drops off the 5-entry tail), Dev Plan §10 row.

assembleDebug + assembleRelease both green (CONTRIBUTING step 4).
2026-09-23 06:14:36 +12:00
2026-08-14 22:51:59 +12:00
2026-08-14 22:51:59 +12:00
2026-08-14 22:51:59 +12:00
2026-08-14 22:51:59 +12:00

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.1.1 release: a single-user, offline note app with hashtags, favourites, task lists, shopping lists with a running total, 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.1.1 (hotfix over v0.4.1.0: saved notes no longer land in Drafts; Enter in a shopping-list price box adds a row) — full release notes ship on its entry on the Releases page.

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.MAINTENANCE are normal release numbers; EMERGENCY is non-zero only for hotfixes shipped out-of-band. versionCode is a monotonic int and always +1 per release. An empty MAINTENANCE/EMERGENCY slot is written as 0. The build refuses to compile if versionName doesn'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.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.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 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 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 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.

S
Description
Privacy-first, on-device note-taking app for Android. All data stays on your device.
https://incido.bl33p.co.nz
Readme
8.5 MiB
0 Stars 1 Watchers 0 Forks
v0.4.2.0
Latest
2026-09-23 16:57:07 +12:00
Languages
Kotlin 98.1%
C 1.1%
Python 0.5%
Shell 0.3%