# Why offline-first ledger matter for small shops

- URL: https://ck.abdohoo.app/pcm/blog/why-an-offline-first-ledger-matters-for-shops
- Product: Credit Khata (https://ck.abdohoo.app/)
- Section: Explainers
- Updated: 2026-10-15

> Offline-first ledger dey save each entry for di device first and upload am later, so di counter no dey ever wait for network, and careful sync dey make sure nothing lost or double.

Offline-first ledger dey write every entry for di shop own device first and e go send am to di server later, anytime network dey. Di counter no dey ever wait for network, sale no dey ever lost because network cut, and careful sync dey make sure each entry reach once, in order. For shop wey dey sell for credit, na di difference between record wey you fit trust and one wey full of holes.

Plenty apps na online-only: every tap dey go server and wait for answer. Dat one dey work for office wey get good Wi-Fi. Shop counter na different place.

## Why network dey cut for counters

Anybody wey dey run shop know di list:

- **No light** wey go off di router.
- **Weak mobile data** inside shop wey get thick wall, for market wey dey underground, or for back of crowded market.
- **Data wey finish** for middle of di month.
- **Busy time**, when everybody for market dey use their phone at once.

None of dem rare. And dem dey happen exactly when di counter busy pass.

## Wetin dey go wrong with online-only ledger

When network cut and di app no fit save, di shop owner get three bad choices:

1. **Make di customer wait**, while di line dey grow for their back.
2. **Write am for paper "for later"**, and hope say person go type am. Some papers no dey ever enter.
3. **Skip am**, and depend on memory.

Each one dey leave hole for di record. Holes dey turn wrong balances, and wrong balances dey turn quarrel with di customer, wey na exactly wetin credit book suppose stop.

Another problem dey wey no too show. If sale go, network cut before answer come back, and di shop owner tap save again, online-only app fit record di same credit sale two times. Di customer go den pay for di same bag of garri two times.

## Wetin offline-first mean for real life

Offline-first ledger dey turn di thing around:

1. **Write for di device.** Di entry go save for di device di moment wey you tap save. Di counter go move to di next customer.
2. **Put am for line.** Entries wey dey wait to upload dey sit for queue wey get order, and di screen dey show say dem dey wait.
3. **Sync for background.** When network come back, di queue go upload by imself, di oldest first.
4. **Only once.** Each entry get im own special key. If upload try again, di server go recognise di key and e no go record am again.
5. **No ever throw away refusal.** If di server refuse entry, for example because dem don remove di customer since, e go dey kept make di shop owner check am, no be say e go just throw am away quietly.

Dat last point dey easy to miss. Sync wey quietly throw away wetin e no fit save almost bad like no sync at all.

## Wetin offline no fit do

To talk true about limits important. Some things need answer from di server and dem go wait for network:

- **Di customer view.** Di shop dey see offline entry at once; di customer go see am only after e sync.
- **To confirm payment claim**, wey must write for di server.
- **Reminder links**, wey di server dey create.
- **Reports** for all your customers.

Good offline-first app dey keep di counter working, and e dey clear about wetin dey wait.

## How Credit Khata dey do am

Dem build Credit Khata for counters wey network no dey steady:

- **Di counter app** (for browser, you fit install am for computer or phone) dey keep im screens, your language and your customer list for di device, so e dey open even without internet once you don use am online. Sales wey you ring for di **Sales** screen dey save for queue for di device, each one with im own key.
- **Sync pill** for di top of di Sales screen dey show **Everything don sync**, how many dey wait, or **E dey sync**, and if you tap am e go show di queue.
- **Sales wey server refuse dey park**, dem no dey throw dem away, under **E no fit save**, with **Try all again** and **Throw am away**. If you wan sign out while sales still dey queue, e go ask you first, because e go waste dem.
- **Di Android app** dey store new customers and all entries, credit, paid and cash, for di phone and sync dem for background.

![Di Sales screen for Credit Khata counter app with di Everything don sync pill for di top right](https://ck.abdohoo.app/storage/content/library/web-counter.webp)Di sync pill dey show quick quick whether every sale don reach di serverDi practical steps, including wetin to do when sale no fit save, dey for [Work offline and keep your ledger for sync](https://ck.abdohoo.app/pcm/help/work-offline-and-sync).

## Questions wey you go ask any ledger app

Anyone wey you dey use, test am before you depend on am:

1. On flight mode and record sale. E save?
2. Close di app and open am again, still offline. Di sale still dey there?
3. On di internet back. E upload by imself?
4. Record sale while network dey blink. E show once, no be two times?
5. Wetin dey happen to entry wey di server refuse? You fit see am?

If app pass all five, di counter fit continue to work even for di worst network day of di month.

## Di bottom line

Credit ledger dey useful only if e complete. For busy counter wey network no dey steady, di only way to keep am complete na to write first and sync later, with care. Na wetin offline-first mean be dat, and na why e matter for small shop pass almost anywhere else.

To see how dis one fit di rest of digital credit book, read [Wetin be credit book? Digital credit book vs paper register](https://ck.abdohoo.app/pcm/blog/what-is-a-khata-book-digital-vs-paper-register), or start with [Book credit sale for di counter](https://ck.abdohoo.app/pcm/help/book-credit-sale-at-counter).

## Frequently asked questions

### Wetin offline-first mean?

Di app dey write each entry for di device first and e dey treat internet as something wey dey come and go. Entries dey upload for background when network dey.

### Offline entry fit record two times when e sync?

No for app wey dem build well. Each entry get im own special key, so if di upload try again, di server go recognise am and record am only once.

### Di customer dey see offline entry sharp sharp?

No until e sync. Di shop dey see am at once for im own device; di customer view go update when di entry reach di server.

### Wetin no fit happen offline?

Anything wey need answer from di server, like to confirm customer payment, to make reminder link or to run reports.
