# ravirampg54-dev/app-todo-list architecture

> Architecture diagram of the GitHub repository ravirampg54-dev/app-todo-list, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/ravirampg54-dev/app-todo-list
- Repository: https://github.com/ravirampg54-dev/app-todo-list

## Overview

RPG-Todo is an offline-first task manager with RPG-themed presentation, delivered as a web app and wrapped for Android with Capacitor. Users create and manage tasks, review filtered and daily views, and optionally schedule reminders; task data and preferences are stored locally, with JSON import/export available. The app also supports multiple themes and installable/offline use. The main behavior is concentrated in app.js; the sampled excerpts show its initialization, task and reminder operations, and integrations, but not every internal call.

Main entry points: [`RPG-Todo/www/app.js`](https://github.com/ravirampg54-dev/app-todo-list/blob/main/RPG-Todo/www/app.js) (Task workflow), [`RPG-Todo/www/index.html`](https://github.com/ravirampg54-dev/app-todo-list/blob/main/RPG-Todo/www/index.html) (App interface), [`RPG-Todo/www/sw.js`](https://github.com/ravirampg54-dev/app-todo-list/blob/main/RPG-Todo/www/sw.js) (Service worker), [`RPG-Todo/android/app/src/main/java/com/rpgtodo/app/MainActivity.java`](https://github.com/ravirampg54-dev/app-todo-list/blob/main/RPG-Todo/android/app/src/main/java/com/rpgtodo/app/MainActivity.java) (Capacitor bridge)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_task_flow["Task management"]
  node_app_ui["App interface<br/>[index.html]"]
  node_task_workflow["Task workflow<br/>[app.js]"]
  node_task_views["Task views<br/>[app.js]"]
  node_preferences["Preferences and themes<br/>[app.js]"]
end

subgraph group_app_services["App services"]
  node_local_storage[("Browser storage<br/>[app.js]")]
  node_task_transfer["JSON transfer<br/>[app.js]"]
  node_reminders["Reminder scheduling<br/>[app.js]"]
end

subgraph group_offline_install["Offline and install"]
  node_service_worker["Service worker<br/>[sw.js]"]
  node_pwa_setup["PWA and install<br/>[app.js]"]
end

subgraph group_android_shell["Android shell"]
  node_android_activity["Capacitor activity<br/>[MainActivity.java]"]
  node_capacitor_bridge["Capacitor bridge<br/>[MainActivity.java]"]
end

node_user(("User"))
node_notification_plugin["Local notifications"]

node_user -->|"uses"| node_app_ui
node_app_ui -->|"triggers"| node_task_workflow
node_task_workflow -->|"loads and saves"| node_local_storage
node_task_workflow -->|"updates views"| node_task_views
node_preferences -->|"loads and saves"| node_local_storage
node_preferences -->|"applies theme"| node_task_views
node_task_workflow -->|"syncs reminders"| node_reminders
node_reminders -->|"schedules notifications"| node_notification_plugin
node_task_transfer -->|"transfers task data"| node_local_storage
node_pwa_setup -->|"registers"| node_service_worker
node_service_worker -->|"caches app shell"| node_app_ui
node_android_activity -->|"extends"| node_capacitor_bridge
node_capacitor_bridge -.->|"hosts web app"| node_app_ui

click node_app_ui "https://github.com/ravirampg54-dev/app-todo-list/blob/main/RPG-Todo/www/index.html"
click node_task_workflow "https://github.com/ravirampg54-dev/app-todo-list/blob/main/RPG-Todo/www/app.js"
click node_task_views "https://github.com/ravirampg54-dev/app-todo-list/blob/main/RPG-Todo/www/app.js"
click node_preferences "https://github.com/ravirampg54-dev/app-todo-list/blob/main/RPG-Todo/www/app.js"
click node_local_storage "https://github.com/ravirampg54-dev/app-todo-list/blob/main/RPG-Todo/www/app.js"
click node_task_transfer "https://github.com/ravirampg54-dev/app-todo-list/blob/main/RPG-Todo/www/app.js"
click node_reminders "https://github.com/ravirampg54-dev/app-todo-list/blob/main/RPG-Todo/www/app.js"
click node_service_worker "https://github.com/ravirampg54-dev/app-todo-list/blob/main/RPG-Todo/www/sw.js"
click node_pwa_setup "https://github.com/ravirampg54-dev/app-todo-list/blob/main/RPG-Todo/www/app.js"
click node_android_activity "https://github.com/ravirampg54-dev/app-todo-list/blob/main/RPG-Todo/android/app/src/main/java/com/rpgtodo/app/MainActivity.java"
click node_capacitor_bridge "https://github.com/ravirampg54-dev/app-todo-list/blob/main/RPG-Todo/android/app/src/main/java/com/rpgtodo/app/MainActivity.java"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_app_ui,node_task_workflow,node_task_views,node_preferences,node_user toneBlue
class node_local_storage,node_task_transfer,node_reminders toneAmber
class node_service_worker,node_pwa_setup toneMint
class node_android_activity,node_capacitor_bridge toneRose
class node_notification_plugin toneIndigo
```

## Components

### Task management

- [App interface](https://github.com/ravirampg54-dev/app-todo-list/blob/main/RPG-Todo/www/index.html): `RPG-Todo/www/index.html`
- [Task workflow](https://github.com/ravirampg54-dev/app-todo-list/blob/main/RPG-Todo/www/app.js): `RPG-Todo/www/app.js`
- [Task views](https://github.com/ravirampg54-dev/app-todo-list/blob/main/RPG-Todo/www/app.js): `RPG-Todo/www/app.js`
- [Preferences and themes](https://github.com/ravirampg54-dev/app-todo-list/blob/main/RPG-Todo/www/app.js): `RPG-Todo/www/app.js`

### App services

- [Browser storage](https://github.com/ravirampg54-dev/app-todo-list/blob/main/RPG-Todo/www/app.js): `RPG-Todo/www/app.js`
- [JSON transfer](https://github.com/ravirampg54-dev/app-todo-list/blob/main/RPG-Todo/www/app.js): `RPG-Todo/www/app.js`
- [Reminder scheduling](https://github.com/ravirampg54-dev/app-todo-list/blob/main/RPG-Todo/www/app.js): `RPG-Todo/www/app.js`

### Offline and install

- [Service worker](https://github.com/ravirampg54-dev/app-todo-list/blob/main/RPG-Todo/www/sw.js): `RPG-Todo/www/sw.js`
- [PWA and install](https://github.com/ravirampg54-dev/app-todo-list/blob/main/RPG-Todo/www/app.js): `RPG-Todo/www/app.js`

### Android shell

- [Capacitor activity](https://github.com/ravirampg54-dev/app-todo-list/blob/main/RPG-Todo/android/app/src/main/java/com/rpgtodo/app/MainActivity.java): `RPG-Todo/android/app/src/main/java/com/rpgtodo/app/MainActivity.java`
- [Capacitor bridge](https://github.com/ravirampg54-dev/app-todo-list/blob/main/RPG-Todo/android/app/src/main/java/com/rpgtodo/app/MainActivity.java): `RPG-Todo/android/app/src/main/java/com/rpgtodo/app/MainActivity.java`

### Other components

- **User**
- **Local notifications**

## Connections

- User → App interface: uses
- App interface → Task workflow: triggers (evidence: `RPG-Todo/www/app.js`)
- Task workflow → Browser storage: loads and saves (evidence: `RPG-Todo/www/app.js`)
- Task workflow → Task views: updates views (evidence: `RPG-Todo/www/app.js`)
- Preferences and themes → Browser storage: loads and saves (evidence: `RPG-Todo/www/app.js`)
- Preferences and themes → Task views: applies theme (evidence: `RPG-Todo/www/app.js`)
- Task workflow → Reminder scheduling: syncs reminders (evidence: `RPG-Todo/www/app.js`)
- Reminder scheduling → Local notifications: schedules notifications (evidence: `RPG-Todo/www/app.js`)
- JSON transfer → Browser storage: transfers task data (evidence: `RPG-Todo/www/app.js`)
- PWA and install → Service worker: registers (evidence: `RPG-Todo/www/app.js`)
- Service worker → App interface: caches app shell (evidence: `RPG-Todo/www/sw.js`)
- Capacitor activity → Capacitor bridge: extends (evidence: `RPG-Todo/android/app/src/main/java/com/rpgtodo/app/MainActivity.java`)
- Capacitor bridge → App interface: hosts web app
