Back to Documentation

User Manual

App: Nomadical

Version: 2.5.0

Owner: KangaBlue.au

Contact: skippy@kangablue.au

Last updated: 2026-04-14

Platform: Android (API 24+)


Introduction

Nomadical is a fully offline survival companion for Android. Everything — AI inference, knowledge articles, document search, GPS, compass, checklists, journal, and SOS tools — runs entirely on your device. After the one-time AI model download, the app requires no internet connection for any feature.

What's in v2.5

Important: Nomadical is a preparedness aid and educational tool. It does not replace professional survival training, medical expertise, or certified emergency equipment. AI answers and document-grounded responses are imperfect — always cross-reference critical information.

Table of Contents


First Launch and AI Model Setup

When you open Nomadical for the first time, you will see the Onboarding Screen.

What the Onboarding Screen Shows

Downloading the AI Model

Skipping the Download

If you tap Skip, you can use all non-AI features immediately. You can download the model later via Settings > AI Model > Download Model.

GPU vs. CPU Inference

When you first use the AI chat or scanner, the app attempts to use your device's GPU for faster responses. If your device does not support GPU acceleration, a notification will appear: "Running on CPU — responses may be slower." This is normal and the AI will still work correctly, just more slowly.


Home Screen Dashboard

The Home Screen is your central hub. It is the first screen you see after onboarding.

Elements on the Home Screen

Greeting & Date

Displays a contextual greeting (Good Morning / Afternoon / Evening) and the current date.

Search Bar

Tap the search bar at the top to search across all 1,000+ survival articles instantly. Results appear as you type, with highlighted snippets showing where your search term appears in each article.

Category Grid (8 Categories)

A 2×4 grid of category cards. Each card shows:

Tap any category card to open the Library filtered to that category.

The 22 categories are:

Quick Actions Row

Three quick-access buttons:

Survival Tip of the Day

A daily rotating tip card showing a short, practical survival tip. The tip changes each day at midnight and stays the same all day. The card shows:

AI Chat FAB

A floating action button (bottom-right area, green) opens the AI Survival Assistant chat.

Persistent SOS FAB

A semi-transparent red button always visible in the bottom-right corner. See Persistent SOS Button.


Survival Knowledge Library

Accessing the Library

Tap the Library tab (book icon) in the bottom navigation bar.

Browsing by Category

The Library screen shows all 22 categories. Tap a category to see its articles listed as cards.

Searching Articles

Search works fully offline using SQLite FTS5 full-text search technology.

Filtering by Difficulty

Above the article list, you will see difficulty filter chips:

Tap a chip to filter. Each article card shows a colored difficulty badge (color-coded by level).

Scenario Tags

Articles are tagged with survival environment scenarios: Desert, Arctic, Jungle, Urban. These tags are visible on article cards and help you identify which articles are most relevant to your environment.

Bookmarked Articles (Favorites)

A Favorites section at the top of the Library shows articles you have bookmarked, sorted by most recently bookmarked. See Bookmarks and Favorites.


Reading Articles

Opening an Article

Tap any article card from the Library or search results to open the full article.

Reading Progress Indicator

As you scroll through an article, a progress bar at the top of the screen fills from left to right, showing how far you have read. This helps you track your position in longer articles.

SVG Diagrams

Some articles include illustrated diagrams — knot-tying guides, shelter layout plans, signal patterns, and more. These are rendered inline within the article text. Pinch to zoom if needed.

Asking the AI About an Article

At the bottom of every article, there is an "Ask AI about this" button. Tapping it opens the AI Chat screen with the input pre-filled with "I'm reading about [article title]." — giving the AI immediate context so you can ask follow-up questions without re-explaining what you're looking at.

Bookmarking from the Article Screen

Tap the bookmark icon in the article's top-right corner to bookmark it for quick access. Tap again to remove the bookmark.


Bookmarks and Favorites

Bookmarking an Article

You can bookmark articles in three ways:

A medium haptic pulse confirms the bookmark was saved.

Viewing Bookmarks

Open the Library tab. Your bookmarked articles appear in the Favorites section at the top, sorted by most recently bookmarked.

Removing a Bookmark

Tap the bookmark icon again in the article reader, or swipe right on the article card in the Favorites list.


My Documents and Chat With Your PDFs

Nomadical lets you import your own PDF survival guides, first aid manuals, field books, or any text document, and then ask the on-device AI questions about them. Everything runs entirely on your phone — documents never leave your device, and no internet connection is used.

Importing a Document

Tip: For faster import, download PDFs to your phone first (via OneDrive, Google Drive, Dropbox, or a browser), then pick them from your Downloads folder.

What Happens During Import

The document row shows its status: e.g. "2.3 MB • 176 chunks indexed • Added 14/4/2026".

Chatting With a Document (single-document mode)

Chatting Across Your Whole Library (cross-library mode)

When you have more than one imported document, an "Ask my library" button appears above Import PDFs in My Docs. Tap it to open a chat that searches every indexed document at once.

When to use which mode:

Tapping a Document (view the PDF)

Tapping the document row (not the chat bubble) opens the built-in PDF viewer. Use this for traditional reading, sharing, or jumping between pages manually.

Sources in AI Answers

Under each AI response, Nomadical shows green source pills linking to the sections of the document the AI used to build the answer.

Tap any pill to jump directly to that page in the PDF viewer. Hit back to return to the chat with your conversation still on screen.

Thinking Indicator

While the AI is working, a three-dot animated indicator appears with a phase label that updates as Nomadical goes through retrieval and generation:

Expect a cross-library answer to take roughly 10–20 seconds on a recent Android phone with GPU, longer if your device falls back to CPU inference.

Deleting a Document

Swipe right-to-left on any document in the My Docs list, or long-press it, and confirm. This removes the file from your device and deletes all indexed chunks.

Limitations


AI Survival Assistant

Accessing the AI Chat

First Use

If the AI model has not been downloaded yet, you will be prompted to download it. See First Launch and AI Model Setup.

The first time you open the chat after installing the model, there may be a brief initialization delay while the model loads into memory. Subsequent opens are faster because the model loads in the background at app launch.

Having a Conversation

The AI is configured with a survival-focused system prompt emphasizing practical, safety-conscious advice.

Chat History

All conversations are saved automatically. To access past sessions:

Starting a New Session

Tap New Chat (or the compose icon) to start a fresh conversation. The previous session is saved in history.

What the AI Can Help With

Remember: AI responses are general guidance. In a real emergency, always cross-reference critical information, especially regarding plant/mushroom identification and medical decisions.

AI Scanner

The AI Scanner uses your device camera and the on-device Gemma 4 2B vision model to identify plants, animals, insects, mushrooms, tools, and other objects.

Accessing the Scanner

Tap the Scan tab (camera icon) in the bottom navigation bar.

Camera Permission

The first time you open the scanner, Android will ask for camera permission. Tap Allow to enable scanning. Without camera permission, you can still use the gallery pick option.

Scanning an Object

Using the Camera:

Using a Gallery Photo:

Understanding Scan Results

The Scan Result screen shows:

Retaking a Scan

Tap Retake to return to the camera viewfinder. The last 10 scan results are cached in memory, so switching between recent results is instant without re-running inference.

Saving a Scan to Your Field Journal

Critical safety note: Never eat or touch a wild plant, mushroom, or animal based solely on this app's identification. The AI can be wrong. Always verify with multiple authoritative sources and, when in doubt, avoid.

Emergency Checklists

Accessing Checklists

Tap the Checklists tab (checklist icon) in the bottom navigation bar.

Pre-Loaded Checklists

Nomadical includes six comprehensive pre-loaded checklists:

Checklist Items
Bug-Out Bag 30+ items
First Aid Kit 25+ items
Vehicle Emergency Kit 20+ items
Home Emergency Supplies 20+ items
Wilderness Day Pack 20+ items
Winter Survival Kit 20+ items

Using a Checklist

Editing Items

Long-press any checklist item to open an edit menu where you can:

Resetting a Checklist

Tap the menu icon (three dots) in the checklist's top-right corner and select Reset. This unchecks all items and returns the checklist to its starting state. A confirmation prompt appears before resetting.

Sharing a Checklist

Tap the Share icon in the checklist header. The checklist is formatted as plain text and shared via the system share sheet — you can send it via messaging apps, email, notes, or any other app.

Creating a Custom Checklist


Field Journal

Accessing the Journal

Tap the Journal tab (open book icon) in the bottom navigation bar.

Journal Entry List

Entries are displayed in chronological order, grouped by date. You can search entries by typing in the search bar at the top — search looks through entry titles and notes text.

Creating a New Journal Entry

Timestamps are automatically added and formatted for readability.

Viewing a Journal Entry

Tap any entry in the list to open the full detail view, showing all fields, the photo (if any), and GPS coordinates.

Auto-Entries from AI Scanner

When you save a scan result to the journal, an entry is automatically created pre-populated with:

You can add additional notes to this entry at any time.

Sharing a Journal Entry

Open a journal entry and tap the Share icon. The entry text (title, notes, timestamp, and coordinates) is shared via the system share sheet.

Deleting Journal Data

To delete all journal entries at once: Settings > Privacy > Clear Journal Data (requires confirmation).

To delete individual entries: Open the entry detail view and tap Delete.


Compass and GPS

Accessing the Compass

How the Compass Works

Nomadical uses your device's rotation vector sensor — a fusion of the magnetometer and accelerometer — for tilt-compensated heading. This means the compass gives accurate readings even when your phone is not held perfectly flat.

A low-pass filter smooths out noisy sensor readings for a steady compass display.

The screen stays on (wakelock active) while the compass is open so it does not sleep during navigation.

Reading the Compass

True North vs. Magnetic North

By default, the compass shows magnetic north. To switch to true north:

Locking a Bearing

Tap the compass dial to lock a bearing. A secondary needle appears on the dial showing your locked bearing. This is useful for:

Tap the dial again to unlock.

GPS Coordinate Formats

Coordinates can be displayed in three formats, selectable in Settings > Compass > Coordinate Format:

Battery Warning

If your device battery drops below 20% while the compass is open, a warning banner appears reminding you to conserve power.


SOS and Emergency Tools

Accessing the SOS Screen

Personal Emergency Information

The SOS screen displays a Personal Info Card with your emergency medical information. This is critical information for first responders.

To set up your personal info:

This information is stored only on your device.

SOS Morse Flashlight

The SOS Morse Flashlight flashes your device's LED in the international SOS pattern (··· — — — ···) with precise timing:

Simultaneously, your device vibrates in the same SOS pattern — dual-channel signaling for maximum visibility and detectability.

To activate:

Quick activation without navigating: Long-press the red SOS FAB from any screen to start the SOS flash immediately.

Note: SOS runs on a background thread to keep the app responsive. Do not force-close the app while SOS is active.

Emergency Signal Reference

The SOS screen includes a reference card with:

Emergency Phone Numbers

A reference card shows international emergency numbers:

If you have any cellular or data connectivity, tapping a phone number launches your phone dialer with the number pre-filled.


App Settings

Accessing Settings

Tap the Settings icon (gear) from the Home Screen or navigation menu.

AI Model Section

Display Section

Font Size Presets

Choose from five sizes: XS / S / M / L / XL. The selected size applies to all text throughout the app immediately. Your choice is saved and remembered between sessions.

Theme Toggle

Switch between:

Compass Section

Privacy Section

Each action requires a confirmation dialog before proceeding:

About Section


Persistent SOS Button

A semi-transparent red SOS button (40dp) is always visible in the bottom-right corner of every main screen in the app. It is intentionally designed to never be hidden.

Single tap: Navigates immediately to the full SOS screen.

Long press: Activates the SOS Morse flashlight and vibration pattern immediately, without navigating away from your current screen. This allows you to signal for help while continuing to reference other app content.


Troubleshooting

The AI Chat is very slow

Cause: Your device is using CPU inference instead of GPU acceleration.

Solution: This is normal on devices without compatible GPU drivers. Responses will still be generated — just more slowly. Shorter, more specific questions get faster answers. Ensure no other heavy apps are running in the background.

The AI model download keeps failing

Solutions:

The compass is spinning erratically

Causes: Magnetic interference from metal objects, other electronics, or cases with magnetic closures.

Solutions:

GPS coordinates are not showing on the compass

Solution: Ensure location permission is granted. Go to Android Settings > Apps > Nomadical > Permissions > Location and set to Allow while using app or Allow all the time. Then return to the compass screen.

The camera won't open for scanning

Solution: Camera permission may have been denied. Go to Android Settings > Apps > Nomadical > Permissions > Camera and tap Allow.

The AI Scanner says "low confidence" on everything

Tips for better scans:

The SOS flashlight stopped working

Solutions:

Journal photos are not showing

Cause: Storage permission may have been revoked, or photos were stored in a location that was cleared.

Solution: Check that Nomadical has storage/media permissions in Android Settings. Photos taken within the app are stored in the app's private storage and should always be accessible as long as the app is installed and data has not been cleared.

The app is using a lot of storage

The AI model is ~2.6 GB. If you do not use AI features frequently, you can delete the model via Settings > AI Model > Delete Model. You can re-download it at any time when you have Wi-Fi access.

I accidentally cleared all my journal data

Unfortunately, this action cannot be undone. The Privacy data clear actions are permanent. We recommend periodically sharing important journal entries via the share function to keep copies elsewhere.

Contact Support

If you encounter an issue not covered here, contact us at skippy@kangablue.au and describe:

We review support emails as soon as practicable and will respond with next steps or a bug fix timeline. Because Nomadical operates entirely offline, we will never ask for your data or chat history — please only share what you believe is relevant to the issue.


Thank you for choosing Nomadical as your offline survival companion. Stay prepared, stay safe.