repos / starfx

commit

af9b763

parent

3dbdd21

author

Eric Bower

date

2024-08-12 20:48:15 +0000 UTC

docs: exposition

1@@ -55,7 +55,7 @@ Furthermore, `async`/`await` is implemented using generator functions. In
2 `starfx`, not everything we want to `await` is a `Promise`!
3 
4 There is so much more to why generators are awesome but at the end of the day,
5-to the end developer, it doesn't really matter that much.
6+to the end developer, you can treat generators the same as `async`/`await`.
7 
8 If you are struggling to understand or are getting confused using generator
9 functions, just use the

 1@@ -3,8 +3,19 @@ title: Models
 2 description: State management in starfx
 3 ---
 4 
 5-Since data normalization is a first-class citizen inside `starfx` we custom
 6-built a react database for your front-end web apps. Our store is most similar to
 7-`redux` but with a couple of important differences.
 8+Once core component of an MVC framework is the Model.
 9 
10-Creating a front-end database starts first with creating a schema.
11+Since data normalization is a first-class citizen inside `starfx`, we built a
12+custom react database for front-end web apps. Like a backend MVC framework, we
13+want to think of managing the FE store like managing a database. So while
14+thinking about models as separate entities, you create all your models by
15+creating a single schema.
16+
17+Managing models in `starfx` leverages two primary concepts: schema and store.
18+
19+The store is a single, global, and reactive object that was built to make
20+updating views easy. It is essentially an event emitter with a javascript object
21+attached to it.
22+
23+Because the goal of this library is to create scalable web apps, we want users
24+to create all their models at the same time inside of a single schema.