You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/extensions/createExtensions.md
+7-6Lines changed: 7 additions & 6 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -55,7 +55,7 @@ Key points:
55
55
56
56
- They allow you to add specific content to files in the base project.
57
57
- Not all files can be modified this way. See [TEMPLATE-FILES.md](https://github.com/scaffold-eth/create-eth/blob/main/contributors/TEMPLATE-FILES.md) for a list of supported template files.
58
-
- To use a template file, create an `*.args.mjs` file in your extension having the same path structure as `*.template.mjs`. For example, to add extra tab in the header, you'd create `extension/packages/nextjs/components/Header.tsx.args.mjs`.
58
+
- To use a template file, create an `*.args.mjs` file in your extension having the same path structure as `*.template.mjs`. For example, to add an extra tab in the header, you'd create `extension/packages/nextjs/components/Header.tsx.args.mjs`.
59
59
60
60
### Advanced Development Workflow
61
61
@@ -92,8 +92,9 @@ The workflow consists of two main parts:
92
92
```
93
93
94
94
This command will create a **new base instance**, similar to running `npx create-eth@latest`.
95
+
Note: It's recommended to create a **new base instance** outside of the `create-eth` folder, so use `../<your-instance-name>`.
95
96
96
-
The name mentioned for the "Your project name" question will be used as the **extension name**. For example, if you provide `eip` as the value to the question, then the final extension name will be `eip`.
97
+
The name mentioned for the "Your project name" question will be used as the **extension name**. For example, if you provide `../eip` as the value to the question, then the final extension name will be `eip`.
97
98
98
99
4.**Develop the Extension:**
99
100
@@ -109,9 +110,9 @@ The workflow consists of two main parts:
109
110
yarn create-extension {projectName}
110
111
```
111
112
112
-
Example: `yarn create-extension eip`
113
+
Example: `yarn create-extension ../eip`
113
114
114
-
This command gathers all changes from the instance and creates an extension in the `create-eth/externalExtensions/${extensionName}` directory. This directory is the actual extension directory (notice it contains only extra files related to your extension changes), which can be published to GitHub and used by others.
115
+
This command gathers all changes from the instance and creates an extension in the `create-eth/externalExtensions/${extensionName}` directory. This directory is the actual extension directory (notice it contains only the extra files related to your extension changes), which can be published to GitHub and used by others.
115
116
116
117
6.**Publish the Extension:**
117
118
@@ -149,10 +150,10 @@ This phase allows you to test your extension locally and see how it works when u
149
150
150
151
The `extensionName` should be present in `create-eth/externalExtensions/${extensionName}`.
151
152
152
-
Let's suppose you named your project "my-dev-instance". Then this `my-dev-instance` should contain all your extension changes. `--dev` will symlink the extension to the instance project.
153
+
Let's suppose you named your project "../my-dev-instance". Then this `../my-dev-instance` should contain all your extension changes. `--dev` will symlink the extension to the instance project.
153
154
154
155
2.**Test and Tweak the Extension:**
155
-
Since the instance is symlinked with the extension, make necessary changes directly in the symlinked files within `my-dev-instance`, and changes should be automatically reflected in the `create-eth/externalExtensions/${extensionName}` directory.
156
+
Since the instance is symlinked with the extension, make necessary changes directly in the symlinked files within `../my-dev-instance`, and the changes should be automatically reflected in the `create-eth/externalExtensions/${extensionName}` directory.
Copy file name to clipboardExpand all lines: static/llms-full.txt
+8-6Lines changed: 8 additions & 6 deletions
Original file line number
Diff line number
Diff line change
@@ -902,7 +902,7 @@ Key points:
902
902
903
903
- They allow you to add specific content to files in the base project.
904
904
- Not all files can be modified this way. See [TEMPLATE-FILES.md](https://github.com/scaffold-eth/create-eth/blob/main/contributors/TEMPLATE-FILES.md) for a list of supported template files.
905
-
- To use a template file, create an `*.args.mjs` file in your extension having the same path structure as `*.template.mjs`. For example, to add extra tab in the header, you'd create `extension/packages/nextjs/components/Header.tsx.args.mjs`.
905
+
- To use a template file, create an `*.args.mjs` file in your extension having the same path structure as `*.template.mjs`. For example, to add an extra tab in the header, you'd create `extension/packages/nextjs/components/Header.tsx.args.mjs`.
906
906
907
907
#### Advanced Development Workflow
908
908
@@ -940,7 +940,9 @@ The workflow consists of two main parts:
940
940
941
941
This command will create a **new base instance**, similar to running `npx create-eth@latest`.
942
942
943
-
The name mentioned for the "Your project name" question will be used as the **extension name**. For example, if you provide `eip` as the value to the question, then the final extension name will be `eip`.
943
+
Note: it's recommended to create a **new base instance** outside of the `create-eth` folder, so use `../<your-instance-name>`.
944
+
945
+
The name mentioned for the "Your project name" question will be used as the **extension name**. For example, if you provide `../eip` as the value to the question, then the final extension name will be `eip`.
944
946
945
947
4. **Develop the Extension:**
946
948
@@ -956,9 +958,9 @@ The workflow consists of two main parts:
956
958
yarn create-extension {projectName}
957
959
```
958
960
959
-
Example: `yarn create-extension eip`
961
+
Example: `yarn create-extension ../eip`
960
962
961
-
This command gathers all changes from the instance and creates an extension in the `create-eth/externalExtensions/${extensionName}` directory. This directory is the actual extension directory (notice it contains only extra files related to your extension changes), which can be published to GitHub and used by others.
963
+
This command gathers all changes from the instance and creates an extension in the `create-eth/externalExtensions/${extensionName}` directory. This directory is the actual extension directory (notice it contains only the extra files related to your extension changes), which can be published to GitHub and used by others.
962
964
963
965
6. **Publish the Extension:**
964
966
@@ -996,10 +998,10 @@ This phase allows you to test your extension locally and see how it works when u
996
998
997
999
The `extensionName` should be present in `create-eth/externalExtensions/${extensionName}`.
998
1000
999
-
Let's suppose you named your project "my-dev-instance". Then this `my-dev-instance` should contain all your extension changes. `--dev` will symlink the extension to the instance project.
1001
+
Let's suppose you named your project "../my-dev-instance". Then this `../my-dev-instance` should contain all your extension changes. `--dev` will symlink the extension to the instance project.
1000
1002
1001
1003
2. **Test and Tweak the Extension:**
1002
-
Since the instance is symlinked with the extension, make necessary changes directly in the symlinked files within `my-dev-instance`, and changes should be automatically reflected in the `create-eth/externalExtensions/${extensionName}` directory.
1004
+
Since the instance is symlinked with the extension, make necessary changes directly in the symlinked files within `../my-dev-instance`, and the changes should be automatically reflected in the `create-eth/externalExtensions/${extensionName}` directory.
0 commit comments