Skip to content

Commit d043fc9

Browse files
committed
add README.md
1 parent 67d4c10 commit d043fc9

File tree

1 file changed

+67
-0
lines changed

1 file changed

+67
-0
lines changed

README.md

Lines changed: 67 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,67 @@
1+
# Org-Android
2+
3+
An Android application for managing and editing Org-mode files on mobile devices.
4+
5+
## Features
6+
7+
- **Org-mode File Management**: Browse, read, and edit Org-mode files stored on your device
8+
- **Full-Text Search**: Search files by name and content with database-backed indexing
9+
- **Favorites**: Quick access to frequently used files
10+
- **Quick Capture**: Widget support for fast note capture
11+
- **Modern UI**: Built with Jetpack Compose and Material Design 3
12+
- **File Rendering**: Native Org-mode syntax rendering with support for headings, lists, and formatting
13+
14+
## Tech Stack
15+
16+
- **Language**: Kotlin
17+
- **UI Framework**: Jetpack Compose
18+
- **Architecture**: MVVM with Clean Architecture
19+
- **Dependency Injection**: Hilt
20+
- **Database**: Room with FTS (Full-Text Search)
21+
- **Async Operations**: Kotlin Coroutines
22+
- **Navigation**: Navigation Compose
23+
- **Org Parser**: org-java library
24+
25+
## Requirements
26+
27+
- Android API 26+ (Android 8.0 Oreo or higher)
28+
- Target SDK: 34
29+
30+
## Building
31+
32+
```bash
33+
./gradlew assembleDebug
34+
```
35+
36+
For release build:
37+
```bash
38+
./gradlew assembleRelease
39+
```
40+
41+
## Project Structure
42+
43+
```
44+
app/src/main/java/com/orgutil/
45+
├── data/ # Data layer (repositories, data sources, database)
46+
├── di/ # Dependency injection modules
47+
├── domain/ # Domain layer (models, use cases, repository interfaces)
48+
├── ui/ # UI layer (screens, viewmodels, components, theme)
49+
├── widget/ # Home screen widgets
50+
└── worker/ # Background workers for file indexing
51+
```
52+
53+
## Key Components
54+
55+
- **File Browser**: Navigate and manage Org files with subdirectory support
56+
- **File Editor**: View and edit Org files with syntax highlighting
57+
- **Search**: Fast file search powered by SQLite FTS
58+
- **Capture Screen**: Quick note capture with template support
59+
- **Background Indexing**: Automatic file content indexing using WorkManager
60+
61+
## License
62+
63+
[Add your license here]
64+
65+
## Contributing
66+
67+
[Add contributing guidelines here]

0 commit comments

Comments
 (0)