In v0.2 the search-active flag lived on a separate StateFlow that the composable never observed: 'if (state.isSearchActive)' in NoteListScreen was always false, so tapping the search icon toggled the internal flag but never updated the UI. Refactor NoteListViewModel.uiState to use combine() over (notes, isSearchActive, rawQuery) so the flag and the current query are folded into the same emitted NoteListUiState. The composable already reads state.isSearchActive, so no changes are needed there. Result: tapping the search icon shows the search field; typing filters the list via the existing ObjectBox 'contains' query; tapping again closes.
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.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.2 (see Changelog below).
Features
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
containsquery — 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
ScaffoldunionsWindowInsets.systemBarswithWindowInsets.ime, so the text field automatically shrinks above the keyboard instead of being hidden behind it.adjustResizeis also set onMainActivityas a pre-Android-15 fallback. - List cards now show a title + body preview. The first non-empty line of a note is treated as its title and rendered in a larger / bolder style; the remainder is shown as an abbreviated preview below it (max 2 lines, ellipsised). Empty notes display as "Untitled".
v0.1.0 (original MVP)
- Create, edit, and delete plain-text notes
- ObjectBox-backed persistence (objectbox.io)
- Material 3 UI with dynamic color (Android 12+), dark/light follows system
- Fully offline — no
INTERNETpermission - Multi-module Android project (Android today, iOS/Desktop-ready later)
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
| 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 |
License
Incido is released under the GNU Affero General Public License v3.0
(AGPL-3.0). See LICENSE for the full text and
NOTICE for attributions.
Any user who runs a modified version as a network service must publish their source code changes. This is intentional — it preserves the "contribute back" guarantee for all downstream users.
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)
├── .gitea/ # Gitea Actions workflow + issue/PR templates
├── CONTRIBUTING.md
├── CODE_OF_CONDUCT.md
└── 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.
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.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
[ ] 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 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. All participants are expected
to follow CODE_OF_CONDUCT.md. By submitting a
contribution you affirm you have the right to license it under AGPL-3.0.