Incido Developer 84900838f7 fix(notelist): search icon now actually opens the search bar
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.
2026-08-14 23:48:54 +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
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.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 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 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.
  • 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 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 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.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
[ ] 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 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. 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.

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%