स्थानीयप्रथमसंयोगः। सन्देशवितरणे (२४ सितम्बे) पुशः। अत्र जाले मृते कथं सत्यं तिष्ठेत्। स्थानीयलेखः, मेलनम्, सम्पातः। न केवलं स्पिनर्; अपथधर्मः।
English (minimizable)
After notification delivery (24 Sep), this post covers local-first and offline sync: local truth first, conflict rules, op logs, idempotent replay, device encryption, sync UX and incremental server feeds.
पूर्ण-शीर्षकम् / Full title
स्थानीयप्रथमसंयोगः: A Metrical Codification of Local-First Sync (with English glosses)
English · overview and topics (minimizable)
What this post is about
Local-first software keeps a usable local replica so users can work offline or on flaky networks, then synchronizes with merge rules.
Topics covered
- Offline availability goal
- Local truth before server round-trip
- Conflict policies (LWW, CRDT, manual)
- Ordered local op logs
- Idempotent sync mutations
- Encrypt local stores
- Visible pending/synced/conflict UX
- Device storage budgets
- Incremental change feeds
- Multi-tenant isolation on device
Sanskrit title
स्थानीयप्रथमसंयोगः = sthānīya-prathama-saṃyogaḥ “connection/sync that is local-first”.
परम्परा-सन्धिः / Series links
| पूर्वं / Prior | अत्र किम् उपचीयते / Adds | किं न पुनरुच्यते / Does not repeat |
|---|---|---|
| पुनःप्रयासन्यायः (१४ अगस्त) | retries | sync resend |
| घटनाप्रवाहः (३० जुलै) | streams | incremental feeds |
| बहुकिरायविवेकः (८ सितम्बे) | tenancy | on-device isolation |
| गोपनीयतालेखः (११ जुलै) | sensitive data | local DB risk |
| इदम् | offline replica conflicts op-log | - |
ग्राह्य-त्याज्य-विवेकः / Keep and avoid
ग्राह्यम् / Keep
१. स्थानीयलेखः: durable local store
२. मेलनन्यायः: documented conflict policy
३. उपकरणपङ्क्तिः: local mutation log
४. इदमर्थमेलनम्: mutation ids on sync
५. उपकरणगोप्यता: encrypt at rest
६. संकेतUI: pending/conflict markers
७. आकारसीमा: evict local caches
त्याज्यम् / Avoid
- block all UI on network
- silent LWW on critical data
- plaintext secrets in IndexedDB/SQLite by default
अध्याय-योजना / Chapter plan
| प्रकरणम् | विषयः | छन्दः | श्लोकाः |
|---|---|---|---|
| १ | मङ्गलं बीजं च / Opening | अनुष्टुभ् | २ |
| २ | मूलतत्त्वानि / Core ideas | अनुष्टुभ् | २ |
| ३ | मुख्यविधिः / Main method | उपजाति | १ |
| ४ | रक्षा · विधिः / Guardrails | अनुष्टुभ् | २ |
| ५ | विवेक · सीमा / Judgment | अनुष्टुभ् | २ |
| ६ | पूर्वसन्धिः / Links to earlier posts | उपजाति | १ |
| ७ | उपसंहारः / Close | अनुष्टुभ् | २ |
पारिभाषिक-कोशः / Glossary
| Modern English | संस्कृतम् | Note |
|---|---|---|
| local-first | स्थानीयप्रथमम् | |
| offline | अपथ / जालरहित | |
| sync | संयोगः / मेलनम् | |
| conflict | सम्पातः / विवादलेखः | |
| CRDT | सह equip मेली संरचना | conflict-free class |
| last-writer-wins | अन्तिमलेखकजयः | |
| op log | कर्मपङ्क्तिः | |
| optimistic UI | आशावादी दृश्यम् | |
| snapshot + diff | पूर्णचित्रं भेदश्च | |
| device keystore | उपकरणकुञ्जीकोशः |
श्लोकः १ (अनुष्टुभ्)
स्थानीयप्रथमसंयोगस्तस्माद् अपथसत्यम् ॥१॥
पदच्छेदः · Word-for-word · English (minimizable)
पदच्छेदः
जालं यदि मृतं तदा कर्म मा म्रियताम् ।
स्थानीयप्रथमसंयोगः तस्मात् अपथसत्यम् ॥
Word-for-word
| संस्कृतपदम् | Word-for-word English |
|---|---|
| जालम् | network |
| यदि मृतम् | if dead |
| कर्म | user work |
| मा म्रियताम् | must not die |
| स्थानीयप्रथमसंयोगः | local-first sync |
| अपथसत्यम् | off-path/offline truth |
Gloss table
| पदम् | अर्थः / sense |
|---|---|
| जालं मृतम् | network down |
| स्थानीयप्रथमम् | local-first |
| अपथसत्यम् | offline truth |
English sense
Local-first means the client can read and write a useful local replica when the network is gone, then sync later.
Context / topic
Topic: offline availability goal.
वृत्तमिति: ८-८-८-८।
श्लोकः २ (अनुष्टुभ्)
केवलं सर्वरप्रतीक्षा बन्धनम् ॥२॥
पदच्छेदः · Word-for-word · English (minimizable)
पदच्छेदः
स्थानीयसत्यं पूर्वं दृश्यं जालसत्यं पश्चात् मेलनम् ।
केवलं सर्वरप्रतीक्षा बन्धनम् ॥
Word-for-word
| संस्कृतपदम् | Word-for-word English |
|---|---|
| स्थानीयसत्यम् | local truth |
| पूर्वम् | first |
| दृश्यम् | shown |
| जालसत्यम् | network truth |
| पश्चात् | later |
| मेलनम् | merging |
| केवलम् | only |
| सर्वरप्रतीक्षा | server wait |
| बन्धनम् | bondage |
Gloss table
| पदम् | अर्थः / sense |
|---|---|
| स्थानीयसत्यम् | local state first |
| मेलनम् | merge/sync |
| सर्वरप्रतीक्षा | wait for server only |
English sense
UI should trust the local store for immediate feedback. Server reconciliation is asynchronous when offline-first is a real goal.
Context / topic
Topic: optimistic local UX.
वृत्तमिति: ८-८-८-८।
श्लोकः ३ (अनुष्टुभ्)
अन्तिमलेखकः मा सर्वत्र अन्धः ॥३॥
पदच्छेदः · Word-for-word · English (minimizable)
पदच्छेदः
सम्पातः लेखयोः यदि द्विधा तदा मेलनन्यायः ।
अन्तिमलेखकः मा सर्वत्र अन्धः ॥
Word-for-word
| संस्कृतपदम् | Word-for-word English |
|---|---|
| सम्पातः | collision/conflict |
| लेखयोः | of two writes |
| द्विधा | twofold |
| मेलनन्यायः | merge dharma |
| अन्तिमलेखकः | last writer wins |
| मा सर्वत्र | not everywhere |
| अन्धः | blind |
Gloss table
| पदम् | अर्थः / sense |
|---|---|
| सम्पातः | conflict |
| मेलनन्यायः | merge rule |
| अन्तिमलेखकः | last-writer-wins |
English sense
Conflicts need a stated strategy: LWW, CRDT, field-wise merge or manual resolve. Blind last-writer-wins can drop money or medical edits.
Context / topic
Topic: conflict resolution.
वृत्तमिति: ८-८-८-८।
श्लोकः ४ (अनुष्टुभ्)
बिना क्रमात् मेलनं भ्रष्टम् ॥४॥
पदच्छेदः · Word-for-word · English (minimizable)
पदच्छेदः
क्रमरक्षिणी पङ्क्तिः परिवर्तनानां लेख्या ।
बिना क्रमात् मेलनं भ्रष्टम् ॥
Word-for-word
| संस्कृतपदम् | Word-for-word English |
|---|---|
| क्रमरक्षिणी | order-keeping |
| पङ्क्तिः | log/queue |
| परिवर्तनानाम् | of mutations |
| लेख्या | must be recorded |
| बिना क्रमात् | without order |
| मेलनम् | sync |
| भ्रष्टम् | corrupt |
Gloss table
| पदम् | अर्थः / sense |
|---|---|
| क्रमरक्षिणी पङ्क्तिः | ordered op log |
| परिवर्तनानाम् | of changes |
English sense
Keep a local operation log with causal metadata so sync can replay safely.
Context / topic
Topic: op log / change feed on device.
वृत्तमिति: ८-८-८-८।
श्लोकः ५ (उपजाति)
द्विः लेखं वारयेत् ।
मोबाइलजाले
यत्नो नित्यः ॥५॥
पदच्छेदः · Word-for-word · English (minimizable)
पदच्छेदः
इदमर्थता पुनःप्रेषणे द्विः लेखं वारयेत् ।
मोबाइलजाले यत्नः नित्यः ॥
Word-for-word
| संस्कृतपदम् | Word-for-word English |
|---|---|
| इदमर्थता | same-effect-if-repeated |
| पुनःप्रेषणे | when resending |
| द्विः लेखम् | double write |
| वारयेत् | should block |
| मोबाइलजाले | on mobile network |
| यत्नः | retry |
| नित्यः | constant |
Gloss table
| पदम् | अर्थः / sense |
|---|---|
| इदमर्थता | idempotency |
| पुनःप्रेषणे | on resend |
| मोबाइलजाले | on flaky mobile nets |
English sense
Sync retries are normal on mobile. Server apply paths must be idempotent by mutation id.
Context / topic
Topic: idempotent sync. Links to retry + idempotency.
सन्धिः: पुनःप्रयासन्यायः on the wire; local-first at the edge.
वृत्तमिति: एकादशाक्षराः पादाः।
श्लोकः ६ (अनुष्टुभ्)
चोरलॅपटॉपे नग्नDB मास्तु ॥६॥
पदच्छेदः · Word-for-word · English (minimizable)
पदच्छेदः
गोप्यं स्थाने उपकरणे कोशवद् रक्ष्यम् ।
चोरलॅपटॉपे नग्नDB मास्तु ॥
Word-for-word
| संस्कृतपदम् | Word-for-word English |
|---|---|
| गोप्यम् | secret/sensitive |
| स्थाने | at rest |
| उपकरणे | on device |
| कोशवत् | like vault |
| रक्ष्यम् | to be protected |
| चोरलॅपटॉपे | on stolen laptop |
| नग्नDB | naked DB |
| मास्तु | must not be |
Gloss table
| पदम् | अर्थः / sense |
|---|---|
| उपकरणे | on device |
| कोशवद् | like a vault |
| नग्नDB | plaintext local DB |
English sense
Encrypt local stores at rest; bind keys to platform keystores when possible. Offline does not mean unprotected.
Context / topic
Topic: on-device encryption.
वृत्तमिति: ८-८-८-८।
श्लोकः ७ (अनुष्टुभ्)
द्विसत्यं जनं मा भ्रमयतु मौने ॥७॥
पदच्छेदः · Word-for-word · English (minimizable)
पदच्छेदः
सम्पादनसंकेताः UI मध्ये जीर्णनवं च ।
द्विसत्यं जनं मा भ्रमयतु मौने ॥
Word-for-word
| संस्कृतपदम् | Word-for-word English |
|---|---|
| सम्पादनसंकेताः | sync indicators |
| UI मध्ये | in the UI |
| जीर्णनवम् | stale and fresh |
| द्विसत्यम् | dual truth |
| जनम् | user |
| मा भ्रमयतु | must not confuse |
| मौने | in silence |
Gloss table
| पदम् | अर्थः / sense |
|---|---|
| सम्पादनसंकेताः | sync status markers |
| जीर्णनवम् | stale vs fresh |
| द्विसत्यम् | two truths |
English sense
Show pending, synced, conflict states. Silent dual truth trains users to distrust the app.
Context / topic
Topic: UX for sync state.
वृत्तमिति: ८-८-८-८।
श्लोकः ८ (अनुष्टुभ्)
अनन्तमेडिया कुण्डं हन्ति ॥८॥
पदच्छेदः · Word-for-word · English (minimizable)
पदच्छेदः
आकारसीमा स्थानीयभण्डारे मिता ।
अनन्तमेडिया कुण्डं हन्ति ॥
Word-for-word
| संस्कृतपदम् | Word-for-word English |
|---|---|
| आकारसीमा | size limit |
| स्थानीयभण्डारे | in local store |
| मिता | measured |
| अनन्तमेडिया | endless media |
| कुण्डम् | device storage |
| हन्ति | kills |
Gloss table
| पदम् | अर्थः / sense |
|---|---|
| आकारसीमा | size quota |
| अनन्तमेडिया | unbounded media cache |
English sense
Evict caches; bound offline attachments. Local-first is not infinite disk.
Context / topic
Topic: storage budgets on device.
वृत्तमिति: ८-८-८-८।
श्लोकः ९ (अनुष्टुभ्)
पूर्णपुनराकर्षणं महत् दुःखम् ॥९॥
पदच्छेदः · Word-for-word · English (minimizable)
पदच्छेदः
घटनाप्रवाहः सर्वरे मेलनं पोषयेत् ।
पूर्णपुनराकर्षणं महत् दुःखम् ॥
Word-for-word
| संस्कृतपदम् | Word-for-word English |
|---|---|
| घटनाप्रवाहः | event/change stream |
| सर्वरे | on server |
| मेलनम् | sync |
| पोषयेत् | should feed |
| पूर्णपुनराकर्षणम् | full pull again |
| महत् दुःखम् | great pain |
Gloss table
| पदम् | अर्थः / sense |
|---|---|
| घटनाप्रवाहः | event stream/changes |
| पूर्णपुनराकर्षणम् | full resync always |
English sense
Prefer incremental change feeds from server to device after first snapshot. Full snapshot every open does not scale.
Context / topic
Topic: incremental sync protocol. Links to event streaming (30 Jul).
वृत्तमिति: ८-८-८-८।
श्लोकः १० (उपजाति)
कुटुम्बभेदं रक्षतु ।
साझलॅपटॉपे
स्रावो महाभयम् ॥१०॥
पदच्छेदः · Word-for-word · English (minimizable)
पदच्छेदः
बहुकिरायविवेकः उपकरणे कुटुम्बभेदं रक्षतु ।
साझलॅपटॉपे स्रावः महाभयम् ॥
Word-for-word
| संस्कृतपदम् | Word-for-word English |
|---|---|
| बहुकिरायविवेकः | multi-tenant dharma |
| उपकरणे | on device |
| कुटुम्बभेदम् | tenant separation |
| रक्षतु | must guard |
| साझलॅपटॉपे | on shared laptop |
| स्रावः | leak |
| महाभयम् | great danger |
Gloss table
| पदम् | अर्थः / sense |
|---|---|
| कुटुम्बभेदम् | tenant isolation |
| साझलॅपटॉपे | shared laptop |
| स्रावः | leak |
English sense
Multi-tenant apps must not mix tenant local DBs on one profile without clear switch and wipe rules.
Context / topic
Topic: tenancy on device (8 Sep link).
सन्धिः: बहुकिरायविवेकः extends to local replicas.
वृत्तमिति: एकादशाक्षराः पादाः।
श्लोकः ११ (अनुष्टुभ्)
एभिः स्थानीयप्रथमं अपथसत्यसमन्वितम् ॥११॥
पदच्छेदः · Word-for-word · English (minimizable)
पदच्छेदः
स्थानीयसत्यं मेलनं इदमर्थः गोप्यं संकेतश्च पञ्चकम् ।
एभिः स्थानीयप्रथमं अपथसत्य समन्वितम् ॥
Word-for-word
| संस्कृतपदम् | Word-for-word English |
|---|---|
| स्थानीयसत्यम् | local truth |
| मेलनम् | merge |
| इदमर्थः | idempotency |
| गोप्यम् | privacy |
| संकेतः | UX signal |
| पञ्चकम् | five-set |
Gloss table
| पदम् | अर्थः / sense |
|---|---|
| पञ्चकम् | local truth merge idempotency privacy UX signals |
English sense
Five limbs: local-first read/write, explicit merge rules, idempotent sync, on-device privacy and visible sync state.
Context / topic
Topic: checklist.
वृत्तमिति: ८-८-८-८।
श्लोकः १२ (अनुष्टुभ्)
मितं मेलनं क्रियायोग्यं तन्त्रधर्मः स उच्यते ॥१२॥
पदच्छेदः · Word-for-word · English (minimizable)
पदच्छेदः
इति स्थानीयप्रथमसंयोगसारः अपथसत्य समन्वितः ।
मितं मेलनं क्रियायोग्यं तन्त्रधर्मः सः उच्यते ॥
Word-for-word
| संस्कृतपदम् | Word-for-word English |
|---|---|
| इति | thus |
| स्थानीयप्रथमसंयोगसारः | local-first essence |
| अपथसत्यम् | offline truth |
| मितम् | measured |
| मेलनम् | merging |
| क्रियायोग्यम् | operable |
| तन्त्रधर्मः | system dharma |
Gloss table
| पदम् | अर्थः / sense |
|---|---|
| मितं मेलनम् | measured sync |
| तन्त्रधर्मः | platform dharma |
English sense
Closing: keep work alive offline; reconcile with named conflict laws when the network returns.
Context / topic
Topic: close.
उपसंहारन्यायः: पूर्वं स्थानीयम्; पश्चात् मेलनम्; द्विः मा लेखं दह।
वृत्तमिति: ८-८-८-८।
श्लोकसूची / Verse index
१. Offline goal
२. Local truth first
३. Conflict rules
४. Op log
५. Idempotent sync
६. Device encryption
७. Sync UX
८. Storage budget
९. Incremental feed
१०. Tenant on device
११. Five limbs
१२. Close
सन्दर्भाः / References
- Prior: retry 2026-08-14; streams 2026-07-30; tenancy 2026-09-08; privacy logs 2026-07-11.
- Domain: local-first offline sync CRDT/LWW.
- Bilingual word-for-word + sense.
- Style: no em dash; no Oxford comma in English clauses.