Skip to content

Commit 37e5736

Browse files
committed
docs(quick-start): Update to align with Cedar
1 parent 6400d74 commit 37e5736

File tree

2 files changed

+86
-68
lines changed

2 files changed

+86
-68
lines changed

docs/docs/quick-start.md

Lines changed: 43 additions & 34 deletions
Original file line numberDiff line numberDiff line change
@@ -1,65 +1,69 @@
11
---
2-
description: Redwood quick start
2+
description: CedarJS quick start
33
---
44

55
# Quick Start
66

77
:::info Prerequisites
88

9-
- Redwood requires [Node.js](https://nodejs.org/en/) (=20.x) and [Yarn](https://yarnpkg.com/) (>=1.22.21)
10-
- Are you on Windows? For best results, follow our [Windows development setup](how-to/windows-development-setup.md) guide
9+
- CedarJS requires [Node.js](https://nodejs.org/en/) (=20.19.x) and
10+
[Yarn](https://yarnpkg.com/) (>=1.22.21)
11+
- Are you on Windows? For best results, follow our [Windows development
12+
setup](how-to/windows-development-setup.md) guide
1113

1214
:::
1315

14-
Create a Redwood project with `yarn create cedar-app`:
16+
Create a Cedar project with `yarn create cedar-app`:
1517

1618
```
17-
yarn create cedar-app my-redwood-project
19+
yarn create cedar-app my-cedar-project
1820
```
1921

2022
:::tip Prefer TypeScript?
2123

22-
Redwood comes with full TypeScript support from the get-go:
24+
CedarJS comes with full TypeScript support from the get-go:
2325

2426
```
25-
yarn create cedar-app my-redwood-project --typescript
27+
yarn create cedar-app my-cedar-project --typescript
2628
```
2729

2830
:::
2931

3032
Then change into that directory, yarn install, and start the development server:
3133

3234
```
33-
cd my-redwood-project
35+
cd my-cedar-project
3436
yarn install
35-
yarn redwood dev
37+
yarn cedarjs dev
3638
```
3739

3840
Your browser should automatically open to [http://localhost:8910](http://localhost:8910) where you'll see the Welcome Page, which links out to many great resources:
3941

40-
<img data-mode="light" src="https://user-images.githubusercontent.com/300/145314717-431cdb7a-1c45-4aca-9bbc-74df4f05cc3b.png" alt="Redwood Welcome Page" style={{ marginBottom: 20 }} />
42+
<img data-mode="light" src="https://user-images.githubusercontent.com/300/145314717-431cdb7a-1c45-4aca-9bbc-74df4f05cc3b.png" alt="CedarJS Welcome Page" style={{ marginBottom: 20 }} />
4143

42-
<img data-mode="dark" src="https://user-images.githubusercontent.com/32992335/161387013-2fc6702c-dfd8-4afe-aa2f-9b06d575ba82.png" alt="Redwood Welcome Page" style={{ marginBottom: 20 }} />
44+
<img data-mode="dark" src="https://user-images.githubusercontent.com/32992335/161387013-2fc6702c-dfd8-4afe-aa2f-9b06d575ba82.png" alt="CedarJS Welcome Page" style={{ marginBottom: 20 }} />
4345

44-
Congratulations on running your first Redwood CLI command!
46+
Congratulations on running your first Cedar CLI command!
4547
From dev to deploy, the CLI is with you the whole way.
4648
And there's quite a few commands at your disposal:
4749

4850
```
49-
yarn redwood --help
51+
yarn cedarjs --help
5052
```
5153

5254
For all the details, see the [CLI reference](cli-commands.md).
5355

5456
### GitPod
5557

56-
The fastest way to start a new Redwood project is to use GitPod ([additional documentation for working with GitPod](./how-to/using-gitpod)).
58+
The fastest way to start a new Cedar project is to use GitPod ([additional documentation for working with GitPod](./how-to/using-gitpod)).
5759

5860
[![Open in Gitpod](https://gitpod.io/button/open-in-gitpod.svg)](https://gitpod.io/#https://github.com/redwoodjs/starter)
5961

6062
## Prisma and the database
6163

62-
Redwood wouldn't be a full-stack framework without a database. It all starts with the schema. Open the `schema.prisma` file in `api/db` and replace the `UserExample` model with the following `Post` model:
64+
CedarJS wouldn't be a full-stack framework without a database. It all starts
65+
with the schema. Open the `schema.prisma` file in `api/db` and replace the
66+
`UserExample` model with the following `Post` model:
6367

6468
```js title="api/db/schema.prisma"
6569
model Post {
@@ -70,10 +74,14 @@ model Post {
7074
}
7175
```
7276

73-
Redwood uses [Prisma](https://www.prisma.io/), a next-gen Node.js and TypeScript ORM, to talk to the database. Prisma's schema offers a declarative way of defining your app's data models. And Prisma [Migrate](https://www.prisma.io/migrate) uses that schema to make database migrations hassle-free:
77+
CedarJS uses [Prisma](https://www.prisma.io/), a next-gen Node.js and TypeScript
78+
ORM, to talk to the database. Prisma's schema offers a declarative way of
79+
defining your app's data models. And Prisma
80+
[Migrate](https://www.prisma.io/migrate) uses that schema to make database
81+
migrations hassle-free:
7482

7583
```
76-
yarn rw prisma migrate dev
84+
yarn cedarjs prisma migrate dev
7785
7886
# ...
7987
@@ -91,67 +99,68 @@ You'll be prompted for the name of your migration. `create posts` will do.
9199
Now let's generate everything we need to perform all the CRUD (Create, Retrieve, Update, Delete) actions on our `Post` model:
92100

93101
```
94-
yarn redwood generate scaffold post
102+
yarn cedarjs generate scaffold post
95103
```
96104

97105
Navigate to [http://localhost:8910/posts/new](http://localhost:8910/posts/new), fill in the title and body, and click "Save":
98106

99107
<img src="https://user-images.githubusercontent.com/300/73028004-72262c00-3de9-11ea-8924-66d1cc1fceb6.png" alt="Create a new post" />
100108

101-
Did we just create a post in the database? Yup! With `yarn rw generate scaffold <model>`, Redwood created all the pages, components, and services necessary to perform all CRUD actions on our posts table.
109+
Did we just create a post in the database? Yup! With `yarn cedarjs generate scaffold <model>`, Cedar created all the pages, components, and services necessary to perform all CRUD actions on our posts table.
102110

103111
## Frontend first with Storybook
104112

105113
Don't know what your data models look like?
106-
That's more than ok—Redwood integrates Storybook so that you can work on design without worrying about data.
114+
That's more than ok — Cedar integrates Storybook so that you can work on design without worrying about data.
107115
Mockup, build, and verify your React components, even in complete isolation from the backend:
108116

109117
```
110-
yarn rw storybook
118+
yarn cedarjs storybook
111119
```
112120

113121
Seeing "Couldn't find any stories"?
114122
That's because you need a `*.stories.{tsx,jsx}` file.
115-
The Redwood CLI makes getting one easy enoughtry generating a [Cell](./cells), Redwood's data-fetching abstraction:
123+
The CedarJS CLI makes getting one easy enoughtry generating a [Cell](./cells), CedarJS's data-fetching abstraction:
116124

117125
```
118-
yarn rw generate cell examplePosts
126+
yarn cedarjs generate cell examplePosts
119127
```
120128

121129
The Storybook server should hot reload and now you'll have four stories to work with.
122130
They'll probably look a little bland since there's no styling.
123-
See if the Redwood CLI's `setup ui` command has your favorite styling library:
131+
See if the CedarJS CLI's `setup ui` command has your favorite styling library:
124132

125133
```
126-
yarn rw setup ui --help
134+
yarn cedarjs setup ui --help
127135
```
128136

129-
## Testing with Jest
137+
## Testing with Vitest
130138

131139
It'd be hard to scale from side project to startup without a few tests.
132-
Redwood fully integrates Jest with both the front- and back-ends, and makes it easy to keep your whole app covered by generating test files with all your components and services:
140+
Cedar fully integrates Vitest with both the front- and back-ends, and makes it easy to keep your whole app covered by generating test files with all your components and services:
133141

134142
```
135-
yarn rw test
143+
yarn cedarjs test
136144
```
137145

138-
To make the integration even more seamless, Redwood augments Jest with database [scenarios](testing.md#scenarios) and [GraphQL mocking](testing.md#mocking-graphql-calls).
146+
To make the integration even more seamless, CedarJS augments Vitest with database [scenarios](testing.md#scenarios) and [GraphQL mocking](testing.md#mocking-graphql-calls).
139147

140148
## Ship it
141149

142-
Redwood is designed for both serverless deploy targets like Netlify and Vercel and serverful deploy targets like Render and AWS:
150+
CedarJS is designed for both serverless deploy targets like Netlify and Vercel and serverful deploy targets like Render and AWS:
143151

144152
```
145-
yarn rw setup deploy --help
153+
yarn cedarjs setup deploy --help
146154
```
147155

148156
Don't go live without auth!
149-
Lock down your app with Redwood's built-in, database-backed authentication system ([dbAuth](authentication.md#self-hosted-auth-installation-and-setup)), or integrate with nearly a dozen third-party auth providers:
157+
Lock down your app with CedarJS's built-in, database-backed authentication system ([dbAuth](authentication.md#self-hosted-auth-installation-and-setup)), or integrate with
158+
the most popular third-party auth providers:
150159

151160
```
152-
yarn rw setup auth --help
161+
yarn cedarjs setup auth --help
153162
```
154163

155164
## Next Steps
156165

157-
The best way to learn Redwood is by going through the comprehensive [tutorial](tutorial/foreword.md) and joining the community (via the [Discourse forum](https://community.redwoodjs.com) or the [Discord server](https://discord.gg/redwoodjs)).
166+
The best way to learn CedarJS is by going through the comprehensive [tutorial](tutorial/foreword.md) and joining the community on our [Discord server](https://cedarjs.com/discord)).
Lines changed: 43 additions & 34 deletions
Original file line numberDiff line numberDiff line change
@@ -1,65 +1,69 @@
11
---
2-
description: Redwood quick start
2+
description: CedarJS quick start
33
---
44

55
# Quick Start
66

77
:::info Prerequisites
88

9-
- Redwood requires [Node.js](https://nodejs.org/en/) (=20.x) and [Yarn](https://yarnpkg.com/) (>=1.22.21)
10-
- Are you on Windows? For best results, follow our [Windows development setup](how-to/windows-development-setup.md) guide
9+
- CedarJS requires [Node.js](https://nodejs.org/en/) (=20.19.x) and
10+
[Yarn](https://yarnpkg.com/) (>=1.22.21)
11+
- Are you on Windows? For best results, follow our [Windows development
12+
setup](how-to/windows-development-setup.md) guide
1113

1214
:::
1315

14-
Create a Redwood project with `yarn create cedar-app`:
16+
Create a Cedar project with `yarn create cedar-app`:
1517

1618
```
17-
yarn create cedar-app my-redwood-project
19+
yarn create cedar-app my-cedar-project
1820
```
1921

2022
:::tip Prefer TypeScript?
2123

22-
Redwood comes with full TypeScript support from the get-go:
24+
CedarJS comes with full TypeScript support from the get-go:
2325

2426
```
25-
yarn create cedar-app my-redwood-project --typescript
27+
yarn create cedar-app my-cedar-project --typescript
2628
```
2729

2830
:::
2931

3032
Then change into that directory, yarn install, and start the development server:
3133

3234
```
33-
cd my-redwood-project
35+
cd my-cedar-project
3436
yarn install
35-
yarn redwood dev
37+
yarn cedarjs dev
3638
```
3739

3840
Your browser should automatically open to [http://localhost:8910](http://localhost:8910) where you'll see the Welcome Page, which links out to many great resources:
3941

40-
<img data-mode="light" src="https://user-images.githubusercontent.com/300/145314717-431cdb7a-1c45-4aca-9bbc-74df4f05cc3b.png" alt="Redwood Welcome Page" style={{ marginBottom: 20 }} />
42+
<img data-mode="light" src="https://user-images.githubusercontent.com/300/145314717-431cdb7a-1c45-4aca-9bbc-74df4f05cc3b.png" alt="CedarJS Welcome Page" style={{ marginBottom: 20 }} />
4143

42-
<img data-mode="dark" src="https://user-images.githubusercontent.com/32992335/161387013-2fc6702c-dfd8-4afe-aa2f-9b06d575ba82.png" alt="Redwood Welcome Page" style={{ marginBottom: 20 }} />
44+
<img data-mode="dark" src="https://user-images.githubusercontent.com/32992335/161387013-2fc6702c-dfd8-4afe-aa2f-9b06d575ba82.png" alt="CedarJS Welcome Page" style={{ marginBottom: 20 }} />
4345

44-
Congratulations on running your first Redwood CLI command!
46+
Congratulations on running your first Cedar CLI command!
4547
From dev to deploy, the CLI is with you the whole way.
4648
And there's quite a few commands at your disposal:
4749

4850
```
49-
yarn redwood --help
51+
yarn cedarjs --help
5052
```
5153

5254
For all the details, see the [CLI reference](cli-commands.md).
5355

5456
### GitPod
5557

56-
The fastest way to start a new Redwood project is to use GitPod ([additional documentation for working with GitPod](./how-to/using-gitpod)).
58+
The fastest way to start a new Cedar project is to use GitPod ([additional documentation for working with GitPod](./how-to/using-gitpod)).
5759

5860
[![Open in Gitpod](https://gitpod.io/button/open-in-gitpod.svg)](https://gitpod.io/#https://github.com/redwoodjs/starter)
5961

6062
## Prisma and the database
6163

62-
Redwood wouldn't be a full-stack framework without a database. It all starts with the schema. Open the `schema.prisma` file in `api/db` and replace the `UserExample` model with the following `Post` model:
64+
CedarJS wouldn't be a full-stack framework without a database. It all starts
65+
with the schema. Open the `schema.prisma` file in `api/db` and replace the
66+
`UserExample` model with the following `Post` model:
6367

6468
```js title="api/db/schema.prisma"
6569
model Post {
@@ -70,10 +74,14 @@ model Post {
7074
}
7175
```
7276

73-
Redwood uses [Prisma](https://www.prisma.io/), a next-gen Node.js and TypeScript ORM, to talk to the database. Prisma's schema offers a declarative way of defining your app's data models. And Prisma [Migrate](https://www.prisma.io/migrate) uses that schema to make database migrations hassle-free:
77+
CedarJS uses [Prisma](https://www.prisma.io/), a next-gen Node.js and TypeScript
78+
ORM, to talk to the database. Prisma's schema offers a declarative way of
79+
defining your app's data models. And Prisma
80+
[Migrate](https://www.prisma.io/migrate) uses that schema to make database
81+
migrations hassle-free:
7482

7583
```
76-
yarn rw prisma migrate dev
84+
yarn cedarjs prisma migrate dev
7785
7886
# ...
7987
@@ -91,67 +99,68 @@ You'll be prompted for the name of your migration. `create posts` will do.
9199
Now let's generate everything we need to perform all the CRUD (Create, Retrieve, Update, Delete) actions on our `Post` model:
92100

93101
```
94-
yarn redwood generate scaffold post
102+
yarn cedarjs generate scaffold post
95103
```
96104

97105
Navigate to [http://localhost:8910/posts/new](http://localhost:8910/posts/new), fill in the title and body, and click "Save":
98106

99107
<img src="https://user-images.githubusercontent.com/300/73028004-72262c00-3de9-11ea-8924-66d1cc1fceb6.png" alt="Create a new post" />
100108

101-
Did we just create a post in the database? Yup! With `yarn rw generate scaffold <model>`, Redwood created all the pages, components, and services necessary to perform all CRUD actions on our posts table.
109+
Did we just create a post in the database? Yup! With `yarn cedarjs generate scaffold <model>`, Cedar created all the pages, components, and services necessary to perform all CRUD actions on our posts table.
102110

103111
## Frontend first with Storybook
104112

105113
Don't know what your data models look like?
106-
That's more than ok—Redwood integrates Storybook so that you can work on design without worrying about data.
114+
That's more than ok — Cedar integrates Storybook so that you can work on design without worrying about data.
107115
Mockup, build, and verify your React components, even in complete isolation from the backend:
108116

109117
```
110-
yarn rw storybook
118+
yarn cedarjs storybook
111119
```
112120

113121
Seeing "Couldn't find any stories"?
114122
That's because you need a `*.stories.{tsx,jsx}` file.
115-
The Redwood CLI makes getting one easy enoughtry generating a [Cell](./cells), Redwood's data-fetching abstraction:
123+
The CedarJS CLI makes getting one easy enoughtry generating a [Cell](./cells), CedarJS's data-fetching abstraction:
116124

117125
```
118-
yarn rw generate cell examplePosts
126+
yarn cedarjs generate cell examplePosts
119127
```
120128

121129
The Storybook server should hot reload and now you'll have four stories to work with.
122130
They'll probably look a little bland since there's no styling.
123-
See if the Redwood CLI's `setup ui` command has your favorite styling library:
131+
See if the CedarJS CLI's `setup ui` command has your favorite styling library:
124132

125133
```
126-
yarn rw setup ui --help
134+
yarn cedarjs setup ui --help
127135
```
128136

129-
## Testing with Jest
137+
## Testing with Vitest
130138

131139
It'd be hard to scale from side project to startup without a few tests.
132-
Redwood fully integrates Jest with both the front- and back-ends, and makes it easy to keep your whole app covered by generating test files with all your components and services:
140+
Cedar fully integrates Vitest with both the front- and back-ends, and makes it easy to keep your whole app covered by generating test files with all your components and services:
133141

134142
```
135-
yarn rw test
143+
yarn cedarjs test
136144
```
137145

138-
To make the integration even more seamless, Redwood augments Jest with database [scenarios](testing.md#scenarios) and [GraphQL mocking](testing.md#mocking-graphql-calls).
146+
To make the integration even more seamless, CedarJS augments Vitest with database [scenarios](testing.md#scenarios) and [GraphQL mocking](testing.md#mocking-graphql-calls).
139147

140148
## Ship it
141149

142-
Redwood is designed for both serverless deploy targets like Netlify and Vercel and serverful deploy targets like Render and AWS:
150+
CedarJS is designed for both serverless deploy targets like Netlify and Vercel and serverful deploy targets like Render and AWS:
143151

144152
```
145-
yarn rw setup deploy --help
153+
yarn cedarjs setup deploy --help
146154
```
147155

148156
Don't go live without auth!
149-
Lock down your app with Redwood's built-in, database-backed authentication system ([dbAuth](authentication.md#self-hosted-auth-installation-and-setup)), or integrate with nearly a dozen third-party auth providers:
157+
Lock down your app with CedarJS's built-in, database-backed authentication system ([dbAuth](authentication.md#self-hosted-auth-installation-and-setup)), or integrate with
158+
the most popular third-party auth providers:
150159

151160
```
152-
yarn rw setup auth --help
161+
yarn cedarjs setup auth --help
153162
```
154163

155164
## Next Steps
156165

157-
The best way to learn Redwood is by going through the comprehensive [tutorial](tutorial/foreword.md) and joining the community (via the [Discourse forum](https://community.redwoodjs.com) or the [Discord server](https://discord.gg/redwoodjs)).
166+
The best way to learn CedarJS is by going through the comprehensive [tutorial](tutorial/foreword.md) and joining the community on our [Discord server](https://cedarjs.com/discord)).

0 commit comments

Comments
 (0)