commit 24a150fedaceb210050d1791958e679951606269 · cduck.me/statusphere-example-app-fork

+29 -4
TUTORIAL.md
···

       308
       308
        
               record,

     

       309
       309
        
             })

     

       310
       310
        
           } catch (err) {

     

       311
       311
       -
             ctx.logger.warn({ err }, 'failed to write record')

     

       311
       311
       +
             logger.warn({ err }, 'failed to write record')

     

       312
       312
        
             return res.status(500).json({ error: 'Failed to write record' })

     

       313
       313
        
           }

     

       314
       314
        
       

     
···

       624
       624
        
             })

     

       625
       625
        
             uri = res.uri

     

       626
       626
        
           } catch (err) {

     

       627
       627
       -
             ctx.logger.warn({ err }, 'failed to write record')

     

       627
       627
       +
             logger.warn({ err }, 'failed to write record')

     

       628
       628
        
             return res.status(500).json({ error: 'Failed to write record' })

     

       629
       629
        
           }

     

       630
       630
        
       

     

       631
       631
        
           try {

     

       632
       632
        
             // Optimistically update our SQLite <-- HERE!

     

       633
       633
       -
             await ctx.db

     

       633
       633
       +
             await db

     

       634
       634
        
               .insertInto('status')

     

       635
       635
        
               .values({

     

       636
       636
        
                 uri,

     
···

       641
       641
        
               })

     

       642
       642
        
               .execute()

     

       643
       643
        
           } catch (err) {

     

       644
       644
       -
             ctx.logger.warn(

     

       644
       644
       +
             logger.warn(

     

       645
       645
        
               { err },

     

       646
       646
        
               'failed to update computed view; ignoring as it should be caught by the firehose'

     

       647
       647
        
             )

     
···

       653
       653
        
       ```

     

       654
       654
        
       

     

       655
       655
        
       You'll notice this code looks almost exactly like what we're doing in `firehose.ts`.

     

       656
       656
       +
       

     

       657
       657
       +
       ## Thinking in AT Proto

     

       658
       658
       +
       

     

       659
       659
       +
       In this tutorial we've covered the key steps to building an atproto app. Data is published in its canonical form on users' `at://` repos and then aggregated into apps' databases to produce views of the network.

     

       660
       660
       +
       

     

       661
       661
       +
       When building your app, think in these four key steps:

     

       662
       662
       +
       

     

       663
       663
       +
       - Design the [Lexicon](#) schemas for the records you'll publish into the Atmosphere.

     

       664
       664
       +
       - Create a database for aggregating the records into useful views.

     

       665
       665
       +
       - Build your application to write the records on your users' repos.

     

       666
       666
       +
       - Listen to the firehose to hydrate your aggregated database.

     

       667
       667
       +
       

     

       668
       668
       +
       Remember this flow of information throughout:

     

       669
       669
       +
       

     

       670
       670
       +
       ```

     

       671
       671
       +
              ┌─────Repo put─────┐

     

       672
       672
       +
              │                  ▼

     

       673
       673
       +
       ┌──────┴─────┐      ┌───────────┐

     

       674
       674
       +
       │ App server │      │ User repo │

     

       675
       675
       +
       └────────────┘      └─────┬─────┘

     

       676
       676
       +
              ▲                  │

     

       677
       677
       +
              └────Event log─────┘

     

       678
       678
       +
       ```

     

       679
       679
       +
       

     

       680
       680
       +
       This is how every app in the Atmosphere works, including the [Bluesky social app](https://bsky.app).

     

       656
       681
        
       

     

       657
       682
        
       ## Next steps

     

       658
       683