パッケージ、リポジトリ、アプリカテゴリを検索

GitHub リポジトリtheachoem/storypad

StoryPad

10万回以上のダウンロードを記録したオープンソースの日記・ジャーナルアプリ 🪴

StoryPad のプロジェクト画像
スター
1021
フォーク
132
最終プッシュ(UTC)
2026/11/09
プロジェクト状態
公開中

元の README

以下は英語原文のスナップショットです。最新版は GitHub をご覧ください。

StoryPad

GitHub stars GitHub license GitHub issues

📝 StoryPad is a beautiful, privacy-first, open source journal & diary app designed for people who value simplicity, minimalism, and control over their personal data.

Play Store App Store

og_1200x630

🌟 Key Features

  • Timeline journaling – your life flows naturally, no folders or tabs
  • Dedicated tablet UI – optimized layouts for iPad & Android tablets, making writing and reading more immersive
  • Fully customizable writing – bold, lists, checkboxes, colors, 1300+ Google Fonts
  • Throwback memories – see what you wrote on this day years ago
  • Photo memories – add multiple photos per page with custom layout
  • Feelings & moods tracker – 45+ emotions, history & calendar view
  • Multi-page entries – perfect for novels, prompts, or daily notes
  • Tags, stars & search – keep your story organized and easy to find
  • Privacy first – PIN, FaceID, fingerprint lock; data stays on your device
  • Backup & sync – private Google Drive sync & offline local export
  • Themes & customization – 20+ color themes, dark/light mode, fonts & layouts
  • Export & share – text, markdown, or full backups with attachments (images, audio, etc.)
  • StoryPad Pro (one-time purchase):
    • Customize Backgrounds – Personalize your writing space with themed backgrounds for enhanced focus & creativity
    • Templates– Create your own daily writing templates
    • Relaxing Sounds – Set the mood before you write or read
    • Period Calendar – Track your period and create related story entries
    • Voice Journal – Record and organize voice notes
    • Markdown Export – Export entries in markdown format, fully compatible with Obsidian, Notion, and other editors
    • Writing Stats – View word and character count for your story
    • Pinned Notes – Keep important entries at the top of your timeline for easy access
    • Auto Backup – Keep your stories safe with automatic Google Drive sync
  • Available in 20+ languages – and fully open source for transparency

⚙️ Setup & Run

Before getting started, ensure you have the following tools:

  • Java: 21 (LTS) (for Android)
  • Ruby: 3.3.5 (for IOS)
  • Flutter: 3.29.0

For easy setup and running, the GoogleService-Info.plist and google-services.json are provided directly in this repo, and bin/dev generates an empty Dart-defines fallback automatically (RevenueCat, Maps, Google Sign-In, etc. just no-op). Simply run the project with any of the following commands:

# For android
bin/dev --community

# For ios
bin/dev --community-ios

# For macos
bin/dev --community-macos

🛠 Project Overview

StoryPad is designed with simplicity in mind, both in its UI and codebase. We aimed to keep the code understandable while staying true to Flutter's principles.

1. State Management:

StoryPad uses Provider and Stateful widgets to manage its state, distinctly organized into three levels to avoid confusion:

  • Global State: Managed by ProviderScope, disposed when the app closes.
  • View State: Managed by ChangeNotifierProvider (package:provider/provider.dart), disposed when the page closes.
  • Widget State: Managed by Stateful widgets, where the widget itself controls its own state and is disposed when removed from the tree.
2. MVVM Pattern:

StoryPad leverages the MVVM (Model-View-ViewModel) pattern while each view is composed of three to four key files:

  • Model (optional): Represents the data structure, e.g., StoryDbModel.
  • View: Constructs the view model and builds the UI content, e.g., EditStoryView.
  • ViewContent: Displays the actual UI, keeping the visual layout separate from business logic, e.g., EditStoryContent.
  • ViewModel: Manages business logic, provides data & operations to the view, keeping the UI free from unnecessary logic, e.g., EditStoryViewModel.

MVVM with layers

3. Local Database:

StoryPad uses ObjectBox as the local database solution for persistent data storage. ObjectBox provides fast, efficient, and scalable database operations with rich search capabilities, making it ideal for mobile apps that require high-performance data handling.

🤝 Learn & Contribute

Feel free to clone the StoryPad repository and explore the code. It's a great resource for learning how to build efficient, maintainable mobile apps with Flutter. You can also contribute improvements or new features, helping enhance the project for everyone.

Check out our Contribution Guide for more details on how to contribute. Raise an issue if you need any support.

A big thank you to the maintainers of the packages StoryPad relies on - without their work, StoryPad wouldn't be possible. You can view all the dependencies in the pubspec.yaml file.

📄 License

StoryPad is licensed under the GNU General Public License v3.0. See the LICENSE file for details.

We chose the GPL license to ensure that StoryPad's source code remains free and open. Anyone can use, study, modify, and distribute it - but any modifications must also remain open-source under the same license.

🔗 Connect with Us

  • 🌐 Official Website: StoryPad.me - Explore features, screenshots, and more
  • 💬 Community: r/storypad - Join our Reddit community
  • 🐦 Follow Us: @storypadapp - Get the latest updates on X
Thea Choem GitHub avatar
GitHub 作者

Thea Choem ↗

Enjoys learning and experimenting new things!

Phnom Penh, Cambodia
言語DartSwiftShellCMakeC++JavaScriptJavaKotlinRubyCObjective-C

カテゴリー

依存する Flutter コンポーネント

使用している依存関係

依存関係一覧 83 件

アプリカテゴリー

プロジェクトに合うリポジトリを選ぶには?

用途で絞り込み、開発状況を比較し、採用前に元のリポジトリで要件を確認しましょう。

  1. 名前・作者・説明で検索し、技術トピックで絞り込みます。
  2. スター、フォーク、最近のプッシュを比較します。スターは関心の目安であり、品質の保証ではありません。
  3. 利用前に GitHub で README、ライセンス、Issues を確認します。

情報源と管理

“A repository is the most basic element of GitHub.”

GitHub Docs — About repositories ↗