Overview
ABILITY DaoXin (道心) is not just a utility or a generic planner; it is a philosophy captured in code.
In a world where the final results of our external endeavors are fundamentally unpredictable and temporal, everything eventually fades away. This project was born from a profound question: "When all else evaporates, what truly remains?" The answer is the inner mind and the unrelenting will—the Daoxin.
Human will, however, is fragile by nature. It can only be maintained, fortified, and accumulated through the repetition of intentional daily actions. Project Daoxin is an "Experience-Driven Product" designed to help users modularize, visualize, and map their abstract dedication into an explicit, tangible record of spiritual growth.
Problem Statement
Traditional habit trackers and scheduling software often fail due to three core structural limitations:
- The Pressure of Cold Grids: Most tools present task lists as dry, uninspiring checklists or corporate dashboards, turning self-improvement into an exhausting chore rather than a mindful ritual.
- Lack of Immersive Lore: Checking off a routine lacks an internal narrative. Without a unifying story or immediate conceptual weight, long-term user motivation naturally decays.
- Fragmented Workflows: Daily habits, mid-term milestones, and high-level categorization are rarely unified cleanly. Users are forced to juggle disparate systems, diluting the perceived continuity of their efforts.
To solve these frictions, this project approaches productivity through a singular conclusion: "Translate consistent routine into the Eastern Art of Cultivation."
Architectural Strategy
1. Immersive "Cultivation & Martial Arts" Concept
The entire application layer is stylized with ancient Eastern aesthetic frameworks to evoke a sense of quiet focus:
- Concept Over Checklist: Routines are recontextualized as spiritual 정진 (Progress). Maintaining consistency builds internal 기운 (Qi), allowing users to break through to higher existential ranks. Breaking one's focus leaves them a 범부 (Mortal).
- Trinary Core Infrastructure: The architecture strictly converges into exactly three structural page layers:
- Main View: Displays the central "Daoxin" status indicator and a concise summary of immediate commitments.
- Category View: The domain where user effort is categorized like martial arts disciplines and explicitly translated into self-statistical metrics.
- Schedule View: The core scheduler handling short-term routines and persistent long-term workflows.
2. Core-Dependent Data Architecture
To ensure high utility and internal sync, every data model inside the application is structured hierarchically:
- Subordinate Data Trees: Rather than treating schedules and metrics as isolated state pools, all workflows and nested categories are designed as strict subordinates to the master "Daoxin" core state configuration.
- Unidirectional Integrity: Enforced strictly via TypeScript type unions, ensuring that any lower-level task completion instantly and predictably reflects upward into the user's primary progression metrics.
3. Pure CSS for Zero-Overhead Longevity
To create a serene, minimalist presentation layer reminiscent of traditional ink wash paintings and silk textures without sacrificing platform performance:
- Native Style Execution: Avoided heavy JavaScript CSS-in-JS runtimes and complex preprocessor build chains in favor of pure Vanilla CSS.
- WebView Fluidity: Bypassing framework styling compilation guarantees a flawless, stutter-free 60fps rendering speed during high-frequency data mutations or statistics rendering inside cross-platform layers.
4. Atomic State Boundaries (Jotai)
Managing scattered schedulers and state counters requires predictable decoupling:
- Orthogonal State Nodes: Utilized Jotai to break the global context into small, highly isolated state atoms (
daoxinStateAtom,categoryStatsAtom, etc.). - Targeted Re-renders: Changes within the schedule workflows update their isolated states reactively, flowing into the main page summary view via derived atoms without polluting or re-rendering unrelated layout segments.
Technical Decisions
- React & Functional Hooks Chosen to maintain clear component boundaries and encapsulate atomic logic.
- Jotai (Atomic State) Applied for lightweight, bottom-up state composition and derived calculations.
- Vanilla CSS Selected to achieve zero runtime styling overhead and maximize the product's long-term compatibility and archiving value.
- Capacitor Hybrid Bridge Leveraged to containerize standard web architectures seamlessly, deploying to mobile ecosystems with minimal native friction.
Outcomes and Learnings
- Lore-Driven Productivity: Proved that embedding a rich, traditional metaphor into a utility tool dramatically transforms user psychology from chore-endurance to mindful cultivation.
- Strength in Standard Technologies: Confirmed that balancing lightweight atomic state libraries with native Vanilla CSS yields exceptionally fluid layouts within hybrid WebView shells, proving that clean architecture scales down beautifully.
- Unified Architectural Discipline: Demonstrated that structural cohesion (such as the trinary page hierarchy and strict data dependency) ensures a robust, easily maintainable code structure even within a serverless, local-first context.
Links
- Web App: https://yoonjonglyu.github.io/daoxin
- Google Play Store: https://play.google.com/store/apps/details?id=com.yoonjongryu.daoxin
- GitHub: https://github.com/yoonjonglyu/daoxin
- Status: Stable Production (v2.0.0)
🤝 Contact & License
Author: ISA (@yoonjonglyu)
Copyright © 2026 ISA. All rights reserved.
Licensed under the Apache License 2.0.