create-cedar-app 0.1.0 → 0.1.1-next.20
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +13 -13
- package/dist/create-cedar-app.js +348 -348
- package/package.json +4 -4
- package/templates/js/README.md +1 -106
- package/templates/js/api/package.json +2 -2
- package/templates/js/package.json +2 -2
- package/templates/js/web/package.json +4 -4
- package/templates/ts/README.md +1 -106
- package/templates/ts/api/package.json +2 -2
- package/templates/ts/package.json +2 -2
- package/templates/ts/web/package.json +4 -4
package/README.md
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
[](https://cedarjs.com)
|
|
2
2
|
|
|
3
3
|
<!-- prettier-ignore-start -->
|
|
4
4
|
<p align="center">
|
|
@@ -18,17 +18,17 @@
|
|
|
18
18
|
|
|
19
19
|
<h2 align="center">Ship today with architecture for tomorrow.</h2>
|
|
20
20
|
|
|
21
|
-
|
|
21
|
+
CedarJS is an opinionated framework for modern multi-client applications, built on React, GraphQL, and Prisma with full TypeScript support and ready to go with zero config.
|
|
22
22
|
|
|
23
|
-
Want great developer experience and easy scaling? How about an integrated front- and back-end test suite, boilerplate code generators, component design, logging, API security + auth, and serverless or traditional deploy support?
|
|
23
|
+
Want great developer experience and easy scaling? How about an integrated front- and back-end test suite, boilerplate code generators, component design, logging, API security + auth, and serverless or traditional deploy support? Cedar is here! Cedar works with the components and development workflow you love but with simple conventions and helpers to make your experience even better.
|
|
24
24
|
|
|
25
25
|
<h2>Quick Start</h2>
|
|
26
26
|
|
|
27
|
-
|
|
27
|
+
CedarJS requires Node.js =20.x.
|
|
28
28
|
|
|
29
29
|
```bash
|
|
30
|
-
yarn create cedar-app my-
|
|
31
|
-
cd my-
|
|
30
|
+
yarn create cedar-app my-cedar-app
|
|
31
|
+
cd my-cedar-app
|
|
32
32
|
yarn install
|
|
33
33
|
yarn redwood dev
|
|
34
34
|
```
|
|
@@ -57,7 +57,7 @@ _Contributors are Welcome! Get started [here](https://redwoodjs.com/docs/contrib
|
|
|
57
57
|
|
|
58
58
|
## Description
|
|
59
59
|
|
|
60
|
-
This package creates and installs a
|
|
60
|
+
This package creates and installs a Cedar project, which is the entry point for anyone using CedarJS. It has two parts:
|
|
61
61
|
|
|
62
62
|
- The installation script [`src/create-cedar-app.js`](./src/create-cedar-app.js)
|
|
63
63
|
- Project template code in the [`templates/`](./templates/) directory
|
|
@@ -70,7 +70,7 @@ The installation script is built with [Yargs](https://github.com/yargs/yargs).
|
|
|
70
70
|
|
|
71
71
|
### Template Codebase
|
|
72
72
|
|
|
73
|
-
The project codebase in [`templates/`](./templates/) uses [Yarn Workspaces](https://yarnpkg.com/features/workspaces) for a monorepo project containing the API and Web Sides.
|
|
73
|
+
The project codebase in [`templates/`](./templates/) uses [Yarn Workspaces](https://yarnpkg.com/features/workspaces) for a monorepo project containing the API and Web Sides. Cedar packages are included in `templates/ts/package.json`, `templates/ts/web/package.json`, and `templates/ts/api/package.json`, respectively.
|
|
74
74
|
|
|
75
75
|
### How to run `create-cedar-app` from your local repo and create a project
|
|
76
76
|
|
|
@@ -81,7 +81,7 @@ yarn install
|
|
|
81
81
|
yarn build
|
|
82
82
|
```
|
|
83
83
|
|
|
84
|
-
Then, navigate to the create
|
|
84
|
+
Then, navigate to the create-cedar-app package:
|
|
85
85
|
|
|
86
86
|
```bash
|
|
87
87
|
cd packages/create-cedar-app
|
|
@@ -90,11 +90,11 @@ cd packages/create-cedar-app
|
|
|
90
90
|
Run `yarn node` on the built file (`dist/create-cedar-app.js`) and pass in the path to the new project:
|
|
91
91
|
|
|
92
92
|
```bash
|
|
93
|
-
yarn node ./dist/create-cedar-app.js /path/to/new/
|
|
93
|
+
yarn node ./dist/create-cedar-app.js /path/to/new/cedar-app
|
|
94
94
|
```
|
|
95
95
|
|
|
96
96
|
> [!NOTE]
|
|
97
|
-
> the new project will install with the most recent major
|
|
97
|
+
> the new project will install with the most recent major CedarJS package version by default.
|
|
98
98
|
|
|
99
99
|
### How to run other published versions for debugging
|
|
100
100
|
|
|
@@ -106,7 +106,7 @@ To try the canary version, run:
|
|
|
106
106
|
npx create-cedar-app@canary /path/to/project
|
|
107
107
|
```
|
|
108
108
|
|
|
109
|
-
Note that this will still create a project with the latest stable version, but run the canary version of create-cedar-app, and is mainly useful for debugging this package, and not the
|
|
109
|
+
Note that this will still create a project with the latest stable version, but run the canary version of create-cedar-app, and is mainly useful for debugging this package, and not the CedarJS canary release.
|
|
110
110
|
|
|
111
111
|
You can specify any tag or version instead of `@canary`
|
|
112
112
|
|
|
@@ -117,7 +117,7 @@ There are three options for developing with the installed project:
|
|
|
117
117
|
**1. Upgrade the project to use the latest canary release**
|
|
118
118
|
|
|
119
119
|
```bash
|
|
120
|
-
cd /path/to/new/
|
|
120
|
+
cd /path/to/new/cedar-app
|
|
121
121
|
yarn rw upgrade -t canary
|
|
122
122
|
```
|
|
123
123
|
|