diff --git a/.changeset/old-zoos-wonder.md b/.changeset/old-zoos-wonder.md
new file mode 100644
index 0000000..006a90c
--- /dev/null
+++ b/.changeset/old-zoos-wonder.md
@@ -0,0 +1,6 @@
+---
+"create-v2-addon-repo": patch
+"blueprints-v2-addon": patch
+---
+
+Updated README
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 9f9758c..e836889 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -117,5 +117,33 @@ Here are some guidelines to help you and everyone else.
+
+
+Sync reference repo for blueprints-v2-addon
(for admins)
+
+1. Run the following commands in the `blueprints-v2-addon-output` repo.
+
+ ```sh
+ # Reset project
+ git rm -r .
+
+ # Downstream files
+ git clone --no-checkout git@github.com:ijlee2/embroider-toolbox.git temp
+ cd temp
+ git sparse-checkout set packages/blueprints-v2-addon
+ git checkout
+ cd ..
+
+ # Move files
+ mv temp/packages/blueprints-v2-addon/* .
+ mv temp/packages/blueprints-v2-addon/.* .
+ rm -rf temp
+
+ # Reset CHANGELOG
+ echo "# blueprints-v2-addon" > CHANGELOG.md
+ ```
+
+
+
💡 Have ideas for contribution? Reach out to `@ijlee2` on [Discord](https://discord.com/invite/emberjs)!
diff --git a/README.md b/README.md
index 6a84102..606bc22 100644
--- a/README.md
+++ b/README.md
@@ -20,6 +20,24 @@
- [ember-codemod-v1-to-v2](https://github.com/ijlee2/ember-codemod-v1-to-v2)
+## Tutorials
+
+> [!NOTE]
+>
+> Coming soon (Q4 2024). Please star or watch this repo to help me gauge interest.
+
+### analyze-ember-project-dependencies
+
+- Main tutorial
+
+
+### create-v2-addon-repo
+
+- Create v2 addons (main tutorial)
+- Customize blueprints
+- Customize repo
+
+
## Contributing
See the [Contributing](CONTRIBUTING.md) guide for details.
diff --git a/packages/blueprints-v2-addon/package.json b/packages/blueprints-v2-addon/package.json
index b397999..048b932 100644
--- a/packages/blueprints-v2-addon/package.json
+++ b/packages/blueprints-v2-addon/package.json
@@ -1,6 +1,6 @@
{
"name": "blueprints-v2-addon",
- "version": "0.1.4",
+ "version": "0.1.5",
"private": true,
"description": "Blueprints for v2 addons",
"keywords": [
diff --git a/packages/blueprints-v2-addon/src/blueprints/run-new/__addonLocation__/README.md b/packages/blueprints-v2-addon/src/blueprints/run-new/__addonLocation__/README.md
index db88399..2d15807 100644
--- a/packages/blueprints-v2-addon/src/blueprints/run-new/__addonLocation__/README.md
+++ b/packages/blueprints-v2-addon/src/blueprints/run-new/__addonLocation__/README.md
@@ -22,9 +22,9 @@ pnpm start
-Create entity
+Create files
-From the addon root, run the `generate` command to create the source code and its test file.
+Run the `generate` command (from anywhere inside the addon) to create the source code and its test file.
```sh
pnpm addon generate [options]
@@ -49,9 +49,9 @@ For more information, pass `--help`.
-Remove entity
+Remove files
-From the addon root, run the `destroy` command to remove the source code and its test file.
+Run the `destroy` command (from anywhere inside the addon) to remove the source code and its test file.
```sh
pnpm addon destroy
diff --git a/packages/blueprints-v2-addon/tests/fixtures/run-new/output/packages/ui/form/README.md b/packages/blueprints-v2-addon/tests/fixtures/run-new/output/packages/ui/form/README.md
index 10abef2..a1debe9 100644
--- a/packages/blueprints-v2-addon/tests/fixtures/run-new/output/packages/ui/form/README.md
+++ b/packages/blueprints-v2-addon/tests/fixtures/run-new/output/packages/ui/form/README.md
@@ -22,9 +22,9 @@ pnpm start
-Create entity
+Create files
-From the addon root, run the `generate` command to create the source code and its test file.
+Run the `generate` command (from anywhere inside the addon) to create the source code and its test file.
```sh
pnpm addon generate [options]
@@ -49,9 +49,9 @@ For more information, pass `--help`.
-Remove entity
+Remove files
-From the addon root, run the `destroy` command to remove the source code and its test file.
+Run the `destroy` command (from anywhere inside the addon) to remove the source code and its test file.
```sh
pnpm addon destroy
diff --git a/packages/blueprints-v2-addon/update-blueprints.js b/packages/blueprints-v2-addon/update-blueprints.js
index 6a0cbba..5f6adf4 100755
--- a/packages/blueprints-v2-addon/update-blueprints.js
+++ b/packages/blueprints-v2-addon/update-blueprints.js
@@ -5,7 +5,7 @@ import gitDiffApply from 'git-diff-apply';
import yargs from 'yargs';
import { hideBin } from 'yargs/helpers';
-const CURRENT_VERSION = '0.1.4';
+const CURRENT_VERSION = '0.1.5';
async function updateBlueprints({ from, to }) {
const startTag = from;
diff --git a/packages/create-v2-addon-repo/README.md b/packages/create-v2-addon-repo/README.md
index 6522f36..d836432 100644
--- a/packages/create-v2-addon-repo/README.md
+++ b/packages/create-v2-addon-repo/README.md
@@ -14,10 +14,10 @@ _Codemod to create a repo with v2 addons_
Create a batteries-included project fast:
- Create as many v2 addons as you want
-- Run `generate` and `destroy` commands (Ã la Ember CLI)
-- Tailor addon blueprints to your needs
-- Explore bleeding-edge Ember: `embroider-css-modules`, `glint`, `` tag out of the box
-- Maintain project easily: lint, test, CI, and documentation out of the box
+- Run `generate` and `destroy` commands to create and remove files
+- Tailor blueprints to your needs, or stay close to the default with `update-blueprint` command
+- Explore bleeding-edge Ember: Embroider app, `embroider-css-modules`, `glint`, `` tag out of the box
+- Set up project like a pro: lint, test, CI, and documentation out of the box
## Usage
@@ -36,8 +36,11 @@ Step 2. Change directory to the project root, then run these scripts in sequence
# Install dependencies
pnpm install
-# Build packages
+# Build blueprints-v2-addon
pnpm build
+
+# Install blueprints-v2-addon (one-time)
+pnpm install
```
```sh
@@ -57,6 +60,10 @@ git push -u origin main
Step 3. Use the `new` command to start creating addons.
```sh
+# Specify name
+pnpm addon new ui-form
+
+# Specify location
pnpm addon new @my-org-ui/form --location ui/form
```
diff --git a/packages/create-v2-addon-repo/src/blueprints/blueprints/v2-addon/package.json b/packages/create-v2-addon-repo/src/blueprints/blueprints/v2-addon/package.json
index b397999..048b932 100644
--- a/packages/create-v2-addon-repo/src/blueprints/blueprints/v2-addon/package.json
+++ b/packages/create-v2-addon-repo/src/blueprints/blueprints/v2-addon/package.json
@@ -1,6 +1,6 @@
{
"name": "blueprints-v2-addon",
- "version": "0.1.4",
+ "version": "0.1.5",
"private": true,
"description": "Blueprints for v2 addons",
"keywords": [
diff --git a/packages/create-v2-addon-repo/src/blueprints/blueprints/v2-addon/src/blueprints/run-new/__addonLocation__/README.md b/packages/create-v2-addon-repo/src/blueprints/blueprints/v2-addon/src/blueprints/run-new/__addonLocation__/README.md
index 5ba9277..67b6a64 100644
--- a/packages/create-v2-addon-repo/src/blueprints/blueprints/v2-addon/src/blueprints/run-new/__addonLocation__/README.md
+++ b/packages/create-v2-addon-repo/src/blueprints/blueprints/v2-addon/src/blueprints/run-new/__addonLocation__/README.md
@@ -22,9 +22,9 @@ pnpm start
-Create entity
+Create files
-From the addon root, run the `generate` command to create the source code and its test file.
+Run the `generate` command (from anywhere inside the addon) to create the source code and its test file.
```sh
pnpm addon generate [options]
@@ -49,9 +49,9 @@ For more information, pass `--help`.
-Remove entity
+Remove files
-From the addon root, run the `destroy` command to remove the source code and its test file.
+Run the `destroy` command (from anywhere inside the addon) to remove the source code and its test file.
```sh
pnpm addon destroy
diff --git a/packages/create-v2-addon-repo/src/blueprints/blueprints/v2-addon/tests/fixtures/run-new/output/packages/ui/form/README.md b/packages/create-v2-addon-repo/src/blueprints/blueprints/v2-addon/tests/fixtures/run-new/output/packages/ui/form/README.md
index 10abef2..a1debe9 100644
--- a/packages/create-v2-addon-repo/src/blueprints/blueprints/v2-addon/tests/fixtures/run-new/output/packages/ui/form/README.md
+++ b/packages/create-v2-addon-repo/src/blueprints/blueprints/v2-addon/tests/fixtures/run-new/output/packages/ui/form/README.md
@@ -22,9 +22,9 @@ pnpm start
-Create entity
+Create files
-From the addon root, run the `generate` command to create the source code and its test file.
+Run the `generate` command (from anywhere inside the addon) to create the source code and its test file.
```sh
pnpm addon generate [options]
@@ -49,9 +49,9 @@ For more information, pass `--help`.
-Remove entity
+Remove files
-From the addon root, run the `destroy` command to remove the source code and its test file.
+Run the `destroy` command (from anywhere inside the addon) to remove the source code and its test file.
```sh
pnpm addon destroy
diff --git a/packages/create-v2-addon-repo/src/blueprints/blueprints/v2-addon/update-blueprints.js b/packages/create-v2-addon-repo/src/blueprints/blueprints/v2-addon/update-blueprints.js
index 6a0cbba..5f6adf4 100755
--- a/packages/create-v2-addon-repo/src/blueprints/blueprints/v2-addon/update-blueprints.js
+++ b/packages/create-v2-addon-repo/src/blueprints/blueprints/v2-addon/update-blueprints.js
@@ -5,7 +5,7 @@ import gitDiffApply from 'git-diff-apply';
import yargs from 'yargs';
import { hideBin } from 'yargs/helpers';
-const CURRENT_VERSION = '0.1.4';
+const CURRENT_VERSION = '0.1.5';
async function updateBlueprints({ from, to }) {
const startTag = from;
diff --git a/packages/create-v2-addon-repo/tests/fixtures/typescript/output/my-repo/blueprints/v2-addon/package.json b/packages/create-v2-addon-repo/tests/fixtures/typescript/output/my-repo/blueprints/v2-addon/package.json
index b397999..048b932 100644
--- a/packages/create-v2-addon-repo/tests/fixtures/typescript/output/my-repo/blueprints/v2-addon/package.json
+++ b/packages/create-v2-addon-repo/tests/fixtures/typescript/output/my-repo/blueprints/v2-addon/package.json
@@ -1,6 +1,6 @@
{
"name": "blueprints-v2-addon",
- "version": "0.1.4",
+ "version": "0.1.5",
"private": true,
"description": "Blueprints for v2 addons",
"keywords": [
diff --git a/packages/create-v2-addon-repo/tests/fixtures/typescript/output/my-repo/blueprints/v2-addon/src/blueprints/run-new/__addonLocation__/README.md b/packages/create-v2-addon-repo/tests/fixtures/typescript/output/my-repo/blueprints/v2-addon/src/blueprints/run-new/__addonLocation__/README.md
index db88399..2d15807 100644
--- a/packages/create-v2-addon-repo/tests/fixtures/typescript/output/my-repo/blueprints/v2-addon/src/blueprints/run-new/__addonLocation__/README.md
+++ b/packages/create-v2-addon-repo/tests/fixtures/typescript/output/my-repo/blueprints/v2-addon/src/blueprints/run-new/__addonLocation__/README.md
@@ -22,9 +22,9 @@ pnpm start
-Create entity
+Create files
-From the addon root, run the `generate` command to create the source code and its test file.
+Run the `generate` command (from anywhere inside the addon) to create the source code and its test file.
```sh
pnpm addon generate [options]
@@ -49,9 +49,9 @@ For more information, pass `--help`.
-Remove entity
+Remove files
-From the addon root, run the `destroy` command to remove the source code and its test file.
+Run the `destroy` command (from anywhere inside the addon) to remove the source code and its test file.
```sh
pnpm addon destroy
diff --git a/packages/create-v2-addon-repo/tests/fixtures/typescript/output/my-repo/blueprints/v2-addon/tests/fixtures/run-new/output/packages/ui/form/README.md b/packages/create-v2-addon-repo/tests/fixtures/typescript/output/my-repo/blueprints/v2-addon/tests/fixtures/run-new/output/packages/ui/form/README.md
index 10abef2..a1debe9 100644
--- a/packages/create-v2-addon-repo/tests/fixtures/typescript/output/my-repo/blueprints/v2-addon/tests/fixtures/run-new/output/packages/ui/form/README.md
+++ b/packages/create-v2-addon-repo/tests/fixtures/typescript/output/my-repo/blueprints/v2-addon/tests/fixtures/run-new/output/packages/ui/form/README.md
@@ -22,9 +22,9 @@ pnpm start
-Create entity
+Create files
-From the addon root, run the `generate` command to create the source code and its test file.
+Run the `generate` command (from anywhere inside the addon) to create the source code and its test file.
```sh
pnpm addon generate [options]
@@ -49,9 +49,9 @@ For more information, pass `--help`.
-Remove entity
+Remove files
-From the addon root, run the `destroy` command to remove the source code and its test file.
+Run the `destroy` command (from anywhere inside the addon) to remove the source code and its test file.
```sh
pnpm addon destroy
diff --git a/packages/create-v2-addon-repo/tests/fixtures/typescript/output/my-repo/blueprints/v2-addon/update-blueprints.js b/packages/create-v2-addon-repo/tests/fixtures/typescript/output/my-repo/blueprints/v2-addon/update-blueprints.js
index 6a0cbba..5f6adf4 100755
--- a/packages/create-v2-addon-repo/tests/fixtures/typescript/output/my-repo/blueprints/v2-addon/update-blueprints.js
+++ b/packages/create-v2-addon-repo/tests/fixtures/typescript/output/my-repo/blueprints/v2-addon/update-blueprints.js
@@ -5,7 +5,7 @@ import gitDiffApply from 'git-diff-apply';
import yargs from 'yargs';
import { hideBin } from 'yargs/helpers';
-const CURRENT_VERSION = '0.1.4';
+const CURRENT_VERSION = '0.1.5';
async function updateBlueprints({ from, to }) {
const startTag = from;