jotaBase

offline-first backend for the edge

/ FREE

Databases

Loading…

/ / /

Access control

Configuration

Simulated. Runs the engine's own algorithms and key formats in this page — the revision hash, the write order, the tail and manifest shapes — against this database's tenant id and name. No request is sent and nothing here is read from the server, so what you see is a faithful model rather than live data. R2 is left out; a seal still shows its effect on the manifest and the tail.
Write a document to watch it land in every store Seals at 5 documents, so the tail fills and seals while you watch.
Browser

Client A — IndexedDB

store … · table docs

table meta


                


                

                  
Worker
                    
Stateless

                  
room …

                  

                


                

                  
Durable Object
                    
SyncRoom — in memory

                  
seq 0 · tail 0 / 5

                  

                  
tail — Map keyed by id, so a second write to one
                     document replaces its entry rather than adding one

                  

                  
versions — one counter per document, what the rev is derived from

                  

                  
collections — the durable answer to which collection a document is in

                  

                


                

                  
Durable Object
                    
DO storage — survives eviction

                  
rewritten in full on every write · measured at 0ms

                  

                


                

                  
Workers KV
                    
SYNC_KV

                  
…

                  

                  

                  
…

                  

                  
… access rules, untouched by a write

                


                

                  
Browser
                    
Client B — IndexedDB

                  
store … · table docs

                  

                  
table meta

                  

                

              

            

          


          
          

            
            

              

                
Data flow

                
                  
                  Snapshot only — live sync is off
                
                
                tenant …
              


              

                Browser
                
IndexedDB (Dexie)

                

                  
docs
—

                  
pending
—

                  
size
—

                  
checkpoint
—

                

              


              
POST /_pushGET /_sync


              

                Worker
                
jbase api.jotabase.com

                

                  
last route
idle

                  
outcome
—

                

              


              
DO stub


              

                Durable Object
                
SYNC_ROOM › SyncRoom

                
idFromName(…)

                

                  
seq
—

                  
tail
—

                  
seals at
—

                

                

                

                  WebSocket · — client(s) attached
                

              


              

                every writeat threshold
              


              

                

                  Workers KV
                  
SYNC_KV

                  
    
                    
  • …—
    • 
                    
  • …—
    • 
                    
  • …access rules
    • 
                  

                


                

                  R2
                  
CHUNKS jbase-chunks

                  
…

                  

                    
segments
—

                    
sealed docs
—

                    
size
—

                    
last seal
—

                    
last segment
—

                  

                

              

            


            
            

              Write
              …
              step 1 / 1
              
              
                
                
                
                
                
                
              
            


            

              0 events
              
                
                
                
                
              
            

            

            
            

          


          
          

            


              
              


                

                  

                    
                    
                  

                  

                    Never synced
                  

                  

                  

                    

                    
                  

                


                

                  
                  

                    
                    
                  

                  

                    
LOCAL (IndexedDB)

                    
Docs (non-deleted)–

                    
Checkpoint seq–

                    
Est. size–

                    

                      ⏳ Pending (unconfirmed)
                      0
                    

                    
REMOTE

                    
Total writes (seq)–

                    
Sealed segments–

                    
Sealed doc entries–

                    
Tail (hot queue)–

                    
Total size–

                    
Last sealed–

                    
DELTA

                    
Pending download–

                  

                


                

                  
                  

                    
LOCAL CACHE

                    

                      
                      
                    

                    
SEED DATA

                    

                      Docs
                      
                    

                    

                      
                      
                    

                    
REMOTE MAINTENANCE

                    

                      Seal threshold
                      
                      
                    

                    

                      
                      
                    

                    

                      
                    

                    
DANGER ZONE

                    

                      
                    

                  

                


                

                  
                


                

                  
Syncing documents…

                

              


              
              

                

              


            


            

              
              
    
            
    
          
    
        
    
      
    
    
    

    
    
    
      
    
        
    
          
          /
          
          /
          
          /
          Control
        
    
        
    
          
        
    
      
    
      
    
        
    
          
    Control