Skip to content

adityasood04/Soul-Script

Repository files navigation

SoulScript Logo

SoulScript

A modern, mindful, and beautifully designed journaling app for Android — built with Jetpack Compose.
Your private space for reflection, growth, and self-discovery.

License Stars


📑 Table of Contents


📌 Overview

SoulScript is a beautifully crafted journaling app designed to help you document your thoughts, track your mood, and visualize your personal growth — all while keeping your data secure on-device.


📷 Screenshots

v1 6 0


✨ Features

1️⃣ Personalized & Engaging Experience

  • Warm onboarding flow with daily greetings using your name.
  • Home screen featuring:
    • On This Day memories
    • Recent entries
    • Inspiring Quote of the Day
  • Customizable daily reminders for consistent journaling.

2️⃣ Expressive Journaling

  • Dynamic, gradient backgrounds based on selected mood.
  • Attach sketches with a lag-free Drawing Canvas:
    • Eraser
    • Color picker
    • Undo

3️⃣ Powerful History & Insights

  • Search past entries with full-text search and date filters.
  • Visualize habits with:
    • Writing streak tracker
    • GitHub-style activity heatmap
    • Mood distribution charts

4️⃣ Security & Data Management

  • Passcode & Biometric Lock (Fingerprint/Face ID).
  • Data stored securely on-device via Room.
  • Export entries to a beautifully formatted PDF with custom fonts and headers.

🛠 Tech Stack

Category Technology / Pattern
UI Jetpack Compose
Architecture MVVM (Model-View-ViewModel)
Dependency Injection Hilt
Local Storage Room Database
Preferences Jetpack DataStore
Async Kotlin Coroutines & Flow
Navigation Jetpack Navigation Compose

🚀 Upcoming Features

  • Calendar View — browse entries by date.
  • Photo Attachments — add images to journal entries.
  • Templates — guided prompts to kickstart writing.

🏁 Getting Started

  1. Fork the repo: SoulScript
  2. Clone your fork:
    git clone https://github.com/your-username/Soul-Script.git
    cd Soul-Script
  3. Open the project in the latest version of Android Studio.
  4. Build the project to download all the required Gradle dependencies.
  5. Run the app on an emulator or a physical device.

🤝 Contributing

Contributions are welcome! If you have ideas for new features or find a bug, feel free to open an issue or submit a pull request.

📜 License

This project is licensed under the GPL License – see the LICENSE.md file for details.

About

A modern, mindful, and beautifully designed journaling app for Android, built with Jetpack Compose.

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages