@transclude/create 0.1.0 → 0.1.1
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 +51 -0
- package/package.json +1 -1
package/README.md
ADDED
|
@@ -0,0 +1,51 @@
|
|
|
1
|
+
# @transclude/create
|
|
2
|
+
|
|
3
|
+
Starts a [transclude](https://transclude.dev) project.
|
|
4
|
+
|
|
5
|
+
```sh
|
|
6
|
+
npm create @transclude my-app
|
|
7
|
+
cd my-app
|
|
8
|
+
npm install
|
|
9
|
+
npm run dev
|
|
10
|
+
```
|
|
11
|
+
|
|
12
|
+
## Templates
|
|
13
|
+
|
|
14
|
+
```sh
|
|
15
|
+
npm create @transclude my-app -- --template blank
|
|
16
|
+
```
|
|
17
|
+
|
|
18
|
+
| | |
|
|
19
|
+
| --- | --- |
|
|
20
|
+
| `minimal` | a layout, two pages, a 404 and a stylesheet. The default. |
|
|
21
|
+
| `blank` | one page, with a heading and a paragraph. |
|
|
22
|
+
|
|
23
|
+
Neither brings a fragment, an include or an element. Those are decisions your
|
|
24
|
+
project has not made yet, and the [documentation](https://transclude.dev) shows
|
|
25
|
+
them when you want them.
|
|
26
|
+
|
|
27
|
+
## Options
|
|
28
|
+
|
|
29
|
+
| | |
|
|
30
|
+
| --- | --- |
|
|
31
|
+
| `--template <name>` | `minimal` or `blank` |
|
|
32
|
+
| `--yes` | take the defaults and ask nothing |
|
|
33
|
+
| `--link` | depend on a local checkout of the framework rather than the registry |
|
|
34
|
+
|
|
35
|
+
With no arguments it asks for a directory and a template. Piped or in CI it asks
|
|
36
|
+
nothing and takes the defaults, because hanging on a prompt nobody can see is the
|
|
37
|
+
worse failure.
|
|
38
|
+
|
|
39
|
+
An existing directory is fine when it holds nothing that would be overwritten; a
|
|
40
|
+
`.git` from `git init` is the ordinary case. Anything else is refused rather than
|
|
41
|
+
merged.
|
|
42
|
+
|
|
43
|
+
## What it writes
|
|
44
|
+
|
|
45
|
+
Whatever is in `templates/`, with the package name, the dependency on
|
|
46
|
+
`@transclude/core` and the page heading filled in. Nothing is generated, so
|
|
47
|
+
reading that directory in this package tells you exactly what a new project is.
|
|
48
|
+
|
|
49
|
+
## License
|
|
50
|
+
|
|
51
|
+
MIT
|