Skip to content

Commit 897e970

Browse files
authored
Update get-started.mdx
major update to get started page
1 parent 88f3c26 commit 897e970

File tree

1 file changed

+52
-3
lines changed

1 file changed

+52
-3
lines changed

src/content/docs/browser-rendering/get-started.mdx

Lines changed: 52 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,56 @@ sidebar:
55
order: 2
66
---
77

8-
Browser rendering can be used in two ways:
8+
Cloudflare Browser Rendering allows you to programmatically control a headless browser, enabling you to do things like take screenshots, generate PDFs, and perform automated browser tasks.
99

10-
- [Workers Bindings](/browser-rendering/workers-bindings/) for complex scripts.
11-
- [REST API](/browser-rendering/rest-api/) for simple actions.
10+
There are two ways to use Browser Rendering:
11+
- [REST API](/browser-rendering/rest-api/) for simple, one-off actions, like taking a screenshot, fetching HTML, or generating a PDF.
12+
- [Workers Bindings](/browser-rendering/workers-bindings/) for more complex, multi-step browser automation using [Puppeteer](/browser-rendering/platform/puppeteer/) and [Playwright](/browser-rendering/platform/playwright/).
13+
14+
This guide will help you choose the right path for your needs and get you started with your first Browser Rendering project.
15+
16+
## REST API
17+
18+
The REST API is the perfect choice if you have an existing application and want to perform simple, stateless browser actions.
19+
20+
### Prerequisites
21+
- Sign up for a [Cloudflare account](https://dash.cloudflare.com/sign-up/workers-and-pages).
22+
- Create a [Cloudflare API Token](/fundamentals/api/get-started/create-token/) with `Browser Rendering - Edit` permissions.
23+
24+
### Example: Take a screenshot of the Cloudflare homepage
25+
26+
```bash
27+
<Render
28+
file="example-screenshot-from-url"
29+
product="browser-rendering"
30+
/>
31+
```
32+
33+
The REST API can also be used to:
34+
35+
- [Fetch HTML](/browser-rendering/rest-api/content-endpoint/)
36+
- [Generate a PDF](/browser-rendering/rest-api/pdf-endpoint/)
37+
- [and more...](/browser-rendering/rest-api/)
38+
39+
## Workers Bindings
40+
41+
If you need to build more complex, multi-step browser automation workflows, Workers Bindings are the perfect choice. You can use familiar tools like [Puppeteer](/browser-rendering/platform/puppeteer/) and [Playwright](/browser-rendering/platform/playwright/).
42+
43+
### Prerequisites
44+
<Render file="prereqs" product="workers" />
45+
46+
### Example: Navigate to a URL, take a screenshot, and store in KV
47+
48+
```bash
49+
<Render
50+
file="example-workers-binding-screenshots-from-web"
51+
product="browser-rendering"
52+
/>
53+
```
54+
55+
## Next Steps
56+
If you have any feature requests or notice any bugs, share your feedback directly with the Cloudflare team by joining the [Cloudflare Developers community on Discord](https://discord.cloudflare.com/).
57+
58+
- Check out all the [REST API endpoints](/browser-rendering/rest-api/)
59+
- Try out the [Playwright MCP](/browser-rendering/platform/playwright-mcp/)
60+
- Learn more about Browser Rendering [limits](/browser-rendering/platform/limits/) and [pricing](/browser-rendering/platform/pricing/).

0 commit comments

Comments
 (0)