ReEnchanted
A living storybook for the day you actually lived.
Meet the Book at reenchanted.app →
ReEnchanted turns ordinary daily material — notes, moods, weather, walks, meals,
photos, the people who pass through, the choices you make — into a private,
illustrated book that remembers you and returns. Open it and the day arrives as
small keepable pages. Keep what's true, let the rest wait, and each night the
Book braids your real day into a chapter of a continuing Faerie tale: the Book of
You.
Those chapters can leave the screen. A remarkable week can become a
saddle-stitched issue; a month or season can become a softcover; a year can end
as a cloth-and-gold-foil hardcover with the reader's name on its spine. Together
they form an actual Faerie-tale series of an ordinary life, made to live on a
shelf. Digital PDFs are free, physical Books can be ordered à la carte, and the
optional Bound Year sends three seasonal softcovers and the year's final
hardcover.
It is not a journal app, a habit tracker, a chatbot, or a game UI wearing a
storybook skin. It is a storybook interface for attention — and a small living
world that reaches gently off the screen into your real days.
ReEnchanted is its own thing. Enchantify Academy is the fictional school you
fall into inside the Book — the setting, not a separate product.
The thesis
Real life is the best-written chapter in the book. The most sensory, the most
alive. The app's job is not to optimize, score, or diagnose you — it is to
notice your life with you, like a careful book, until ordinary days become
worth keeping.
The Book speaks in character and forms careful literary opinions about your
story — "this person appears when you describe safety," "harbors and rain keep
gathering," "this belief has been in the margins for months" — but the
machinery underneath stays local, structured, and explicit. Observations, never
clinical claims.
Design principles
- Memory over novelty. New systems should deepen existing memory before
adding another disconnected feature. The goal isn't more page types — it's a
better reader.
- Kept pages are canonical. You decide what becomes real archive. The Book is
built on consent and taste.
- Local first. Private Book material stays on device. The free app requires
no ReEnchanted login, and the generative "local brain" runs on the phone
itself. Monthly stories are free too; optional printed Books use a limited
Stripe payment and delivery record, which never receives the private Book archive.
- Structured before generated. Typed events, ledgers, memories, and source
IDs give generated prose rails, so the world reflects what you actually kept
and did.
- In-world, not dashboard. Data shows up as pages, letters, margins, star
charts, and bound editions — not charts for their own sake.
- No dark patterns. No streaks, no guilt, no notifications begging you back.
The daily loop
surface → keep / let it wait → archive → event & memory → curation → return
The Book surfaces a small set of candidate pages, chosen by a curator that
weighs your attention, fatigue, time of day, and what's alive right now. You keep
what matters. Kept pages persist into the archive and can mint narrative events,
character memories, belief, and continuity signals — which feed the next day's
pages, letters, and stories. Nothing vanishes into a feed.
What's inside
Capture, lightly. Inner weather, one-sentence souvenirs, body and fuel notes,
the day's sky, places, and a craft helper that nudges you toward one true,
concrete sentence before any model embellishes it.
The Book of You. A nightly braid that weaves the day's kept pages — what you
noticed, ate, walked, and chose — into a short personal chapter, with a quality
loop that learns from your feedback and rewrites closer to your day.
A book that remembers. The Book Remembered resurfaces old pages when today
rhymes with them. The Book Notices surfaces patterns, absences, and durations.
Surviving threads become named constellations; the Book even seals dated
wagers in the margins and owns the result when it's wrong.
Bound editions. A week can close as a saddle-stitched issue. Each month's
kept pages bind into a themed PDF edition with its own cover and a foreword
the Book writes about the month. Three months gather into a seasonal softcover;
a year becomes an annual volume of twelve chapters, available as an
illustrated hardcover or in cloth, gold foil, and a printed dust jacket.
A living world. Character letters that remember your choices; Story Pages
that braid your real day with fictional choices; gossip between characters; Ask
the Book; Two Readings where the cast disagrees and you decide. Your real
world bleeds in — your steps set how lively the halls are, poor sleep quiets the
world, the weather outside is the weather in the Stacks.
The Outer Stacks. Anchor a real GPS place and the Book grows it a room with
its own story that deepens every time you return — a fairy-tale answer to
location games.
The Book Fae. Old-law creatures who've read the world but never touched it.
They never want belief — they want noticing; you pay bargains in sensory field
reports, and parley with rules that bend the world.
The Pact War & the Chapters. Five Academy Chapters — five wagers about what a
life is — contest belief across the Book; you're eventually sorted by the pages
you keep. Whichever ascends colors the scenes, tone, and choices the Book writes.
Atmosphere & ritual. ReEnchanted Radio (stations that tint the feed), the
Almanac (the Wheel of the Year and lunar esbats), Today's Sky, the Wonder Compass,
photo Enchantments, and the Margins Atlas — a relationship graph drawn as a
living loom.
The local brain. On-device generation (Gemma/MLX) does the writing. Every
model call is user-initiated, and everything stays usable with graceful fallbacks
when the model is missing or busy.
For the full product and architecture map, read PROJECT_OVERVIEW.md.
Privacy & your data
The most personal app on your phone shouldn't feel like a surveillance product.
ReEnchanted is local-first: no ReEnchanted account is required for the free
app, and there are no ads, attention-selling analytics, or remote copies of the
private Book. Body, weather, location, calendar, and other signals come through
explicit, revocable permissions. Your archive, memories, belief ledgers, and
custom cast are your save — portable via .reenchanted-save.json export/import.
The app and its monthly stories are free. Optional physical orders use Stripe
for the email, payment, and parcel details needed to print and ship a Book; that
doorway never receives the reader's private archive. The only paid additions are
ReEnchanted's own printed editions—not ads or outside-vendor offers.
Status
In active development. Visit reenchanted.app
for the full illustrated tour and TestFlight invitation. You can also star or
watch this repository, or follow development on
Patreon.
Architecture
The codebase carries the working codename InsideCover.
EnchantifyInsideCover.xcodeproj — the iOS/iPadOS app project.InsideCoverApp/ — the SwiftUI app: surfaces, sheets, app services, PDF export,
local-brain integration, and device-only affordances.Shared/ — the SwiftPM core (InsideCoverCore): typed models, curation, source
adapters, story systems, archive/search/export logic, page packs, and world
systems.Tests/InsideCoverCoreTests/ — coverage for the shared policy and domain systems.LandingPage/ and RemotionPromo/ — promotional surfaces, not app runtime code.
License
The source code is open source under the Mozilla Public License 2.0
(MPL-2.0) — see LICENSE. You're free to read, audit, modify, and
redistribute it; changes to MPL-licensed files stay open under the same license,
but you can combine the code with your own files under another license. MPL is
also App Store–friendly, unlike GPL/AGPL.
The app's content is proprietary and not open source: artwork, illustrations,
talismans, audio/radio tracks, paid content packs and world-event packs, and the
ReEnchanted name and branding are All Rights Reserved. MPL grants no trademark
rights, so any fork must be renamed and rebranded. Reader save data belongs to
the reader. See NOTICE for the full code-vs-content breakdown.
In short: the engine is open; the art, audio, and content are ours; your saves
are yours.
Requirements
- macOS with Xcode installed
- iOS 17 SDK or newer
- Network access on first build if Xcode needs to resolve packages
- An Apple development team only for physical-device builds
The shared SwiftPM tests and simulator build do not require a connected iPhone.
The local brain is designed for physical devices; simulator builds compile and
exercise fake/fallback paths.
Build And Test
Run shared-core tests from the repository root:
CLANG_MODULE_CACHE_PATH=/private/tmp/insidecover-module-cache \
SWIFTPM_MODULECACHE_OVERRIDE=/private/tmp/insidecover-spm-module-cache \
swift test
Build the app for iOS Simulator:
xcodebuild \
-project EnchantifyInsideCover.xcodeproj \
-scheme InsideCoverApp \
-configuration Debug \
-destination 'generic/platform=iOS Simulator' \
-derivedDataPath /private/tmp/InsideCoverDerivedData \
build
There is also a helper for the shared test bundle when local signing/provenance
gets in the way:
scripts/swift-test-resigned.sh
You can pass a test class or a single XCTest filter to the helper:
scripts/swift-test-resigned.sh BookCuratorTests
scripts/swift-test-resigned.sh BookCuratorTests/testWorldEventDoorSurfacesFieldworkDuringActiveEvent
Running The App
To run on a simulator, open EnchantifyInsideCover.xcodeproj in Xcode, select
the InsideCoverApp scheme and an iOS simulator, then Run.
To run on a physical device, select the InsideCoverApp target, set your Apple
development team, and change the bundle identifier if Xcode asks for a unique one.
Notes
- Bundle ID:
com.openclaw.enchantify.insidecover
- App target:
InsideCoverApp
- Shared package:
InsideCoverCore
- Supported runtime target: iOS 17+
- App Store readiness notes live in
docs/AppStoreReviewPacket.md,
docs/PrivacyPolicyDraft.md, and docs/AppPrivacyInventory.md.
- The old widget source is intentionally detached from this project and lives
outside the app target.
- The app should remain usable when optional local model assets are missing,
busy, or unavailable.
- Personal save data is portable through
.reenchanted-save.json export/import
and should not be required for a clean build.
