Skip to content

Commit 8a71dd8

Browse files
committed
warning added
1 parent 816424d commit 8a71dd8

1 file changed

Lines changed: 6 additions & 2 deletions

File tree

content/references/concepts/ssr/async-ssr.mdx

Lines changed: 6 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -2,6 +2,10 @@ import {Aside} from '~/components/configurable/Aside'
22

33
<Title>Async SSR</Title>
44

5+
<Aside type="warning">
6+
This is a low level API intended for use by library authors. If you would like to use server side rendering in your application we suggest making use of <a href="https://start.solidjs.com/getting-started/what-is-solidstart">Solid Start</a> our meta-framework that makes adding server side rendering to your application extremely easy.
7+
</Aside>
8+
59
## What is Async SSR?
610

711
Async SSR is a server side rendering technique used by most javascript meta-frameworks like Next.js, Nuxt.js, Gatsby, etc. It is a technique that allows you to completely render your application on the server and send the HTML to the client along with the appropriate asynchronous data already fetched. This allows the client to render the page without having to wait for the data to be fetched.
@@ -92,10 +96,10 @@ export default function App() {
9296

9397
#### Limitations
9498

95-
The main limitation of `renderToStringAsync` is that it is completely server dependant. This means that server speed and availability will directly affect the performance of your application. This is because the client will have to wait for the server to render the application before it can be hydrated. This is not a problem if you have a fast server and a lot of resources, but it can be a problem if you have a slow server or a lot of users. In this case, you may want to consider using `renderToString` instead.
99+
The main limitation of `renderToStringAsync` is that it is completely server dependent. This means that server speed and availability will directly affect the performance of your application. This is because the client will have to wait for the server to render the application before it can be hydrated. This is not a problem if you have a fast server and a lot of resources, but it can be a problem if you have a slow server or a lot of users. In this case, you may want to consider using `renderToString` instead.
96100

97101
A slight disadvantage of `renderToStringAsync` is that the time to first paint is blocked by how long it takes to load data on the server. This is not a problem with fast servers but may be problematic with slow servers.
98102

99103
#### Benefits
100104

101-
The main benefit of `renderToStringAsync` is that it is completely client agnostic. This means that you can render your application on the server and send the HTML to the client without having to worry about client side data fetching. This is a huge benefit because it allows you to completely decouple your application from the client. This means that you can use any client you want without having to worry about data fetching.
105+
The main benefit of `renderToStringAsync` is that it is completely client agnostic. This means that you can render your application on the server and send the HTML to the client without having to worry about client side data fetching. This is a huge benefit because it allows you to completely decouple your application from the client. This means that you can use any client you want without having to worry about data fetching.

0 commit comments

Comments
 (0)