Skip to content

Commit 29ec743

Browse files
authored
Add "Should I use this demo for benchmarks?" (#57)
1 parent 9285cbd commit 29ec743

File tree

1 file changed

+11
-0
lines changed

1 file changed

+11
-0
lines changed

README.md

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -2,6 +2,7 @@
22

33
* [What is this?](#what-is-this)
44
* [When will I be able to use this?](#when-will-i-be-able-to-use-this)
5+
* [Should I use this demo for benchmarks?](#should-i-use-this-demo-for-benchmarks)
56
* [Setup](#setup)
67
* [DB Setup](#db-setup)
78
+ [Step 1. Create the Database](#step-1-create-the-database)
@@ -21,6 +22,16 @@ This is a demo app built with Server Components, an experimental React feature.
2122

2223
Server Components are an experimental feature and **are not ready for adoption**. For now, we recommend experimenting with Server Components via this demo app. **Use this in your projects at your own risk.**
2324

25+
## Should I use this demo for benchmarks?
26+
27+
If you use this demo to compare React Server Components to the framework of your choice, keep this in mind:
28+
29+
* **This demo doesn’t have server rendering.** Server Components are a separate (but complementary) technology from Server Rendering (SSR). Server Components let you run some of your components purely on the server. SSR, on the other hand, lets you generate HTML before any JavaScript loads. This demo *only* shows Server Components, and not SSR. Because it doesn't have SSR, the initial page load in this demo has a client-server network waterfall, and **will be much slower than any SSR framework**. However, Server Components are meant to be integrated together with SSR, and they *will* be in a future release.
30+
* **This demo doesn’t have an efficient bundling strategy.** When you use Server Components, a bundler plugin will automatically split the client JS bundle. However, the way it's currently being split is not necessarily optimal. We are investigating more efficient ways to split the bundles, but they are out of scope of this demo.
31+
* **This demo doesn’t have partial refetching.** Currently, when you click on different “notes”, the entire app shell is refetched from the server. However, that’s not ideal: for example, it’s unnecessary to refetch the sidebar content if all that changed is the inner content of the right pane. Partial refetching is an [open area of research](https://github.com/josephsavona/rfcs/blob/server-components/text/0000-server-components.md#open-areas-of-research) and we don’t yet know how exactly it will work.
32+
33+
This demo is provided “as is” to show the parts that are ready for experimentation. It is not intended to reflect the performance characteristics of a real app driven by a future stable release of Server Components.
34+
2435
## Setup
2536

2637
You will need to have nodejs >=14.9.0 in order to run this demo. [Node 14 LTS](https://nodejs.org/en/about/releases/) is a good choice! (If you use `nvm`, run `nvm i` before running `npm install` to install the recommended Node version.)

0 commit comments

Comments
 (0)