@mayrlabs/setup-project 0.1.7 โ 0.1.8
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/CHANGELOG.md +6 -0
- package/README.md +52 -19
- package/dist/index.js +1577 -131
- package/dist/index.mjs +1675 -141
- package/package.json +6 -3
package/CHANGELOG.md
CHANGED
package/README.md
CHANGED
|
@@ -1,35 +1,68 @@
|
|
|
1
1
|
# @mayrlabs/setup-project
|
|
2
2
|
|
|
3
|
-
Interactive CLI to
|
|
3
|
+
**Interactive CLI to fast-track your project setup.**
|
|
4
4
|
|
|
5
|
-
|
|
5
|
+
๐ **Spin up a production-ready environment in seconds.**
|
|
6
6
|
|
|
7
|
-
|
|
8
|
-
- ๐
**Formatter**: Choose between **Prettier** or **Oxfmt**.
|
|
9
|
-
- ๐งน **Linter**: Choose between **ESLint** or **Oxlint**.
|
|
10
|
-
- ๐ซ **Lint-staged**: Automatically lint/format staged files with broad extension support.
|
|
11
|
-
- ๐ณ **Env Validation**: Set up **@t3-oss/env** for Next.js, Nuxt, or Core, with optional presets.
|
|
12
|
-
- ๐งช **Testing**: Configure **Vitest** or **Jest**.
|
|
13
|
-
- โ๏ธ **EditorConfig**: Generate standardized `.editorconfig` files.
|
|
14
|
-
- ๐ **License**: Generate MIT, ISC, or Apache-2.0 licenses.
|
|
15
|
-
- ๐ก๏ธ **Git Safety**: Checks for uncommitted changes before making modifications.
|
|
7
|
+
Starting a new project often involves hours of repetitive configuration: setting up linting, formatting, git hooks, testing frameworks, and more. `@mayrlabs/setup-project` automates this entirely.
|
|
16
8
|
|
|
17
|
-
|
|
9
|
+
Instead of copy-pasting `.eslintrc` files or manually installing dependencies, just run one command and let our interactive CLI handle the rest.
|
|
18
10
|
|
|
19
|
-
|
|
11
|
+
## Why use this?
|
|
12
|
+
|
|
13
|
+
- **Zero Config Fatigue**: No more wrestling with disparate config files. We provide sensible, battle-tested defaults.
|
|
14
|
+
- **Modern Stack Support**: Best-in-class support for the tools you actually use: Prettier, ESLint, Husky, Vitest, and more.
|
|
15
|
+
- **Interactive & Safe**: The CLI iterates with you. Pick exactly what you need. It even checks for a clean git state before making changes.
|
|
16
|
+
- **Extensible**: Need to add a Tailwind plugin to Prettier? We got you. The `plugin` command makes extending your tools a breeze.
|
|
17
|
+
|
|
18
|
+
## Quick Start
|
|
19
|
+
|
|
20
|
+
Run the CLI in your project root:
|
|
20
21
|
|
|
21
22
|
```bash
|
|
22
23
|
npx @mayrlabs/setup-project@latest
|
|
23
24
|
```
|
|
24
25
|
|
|
25
|
-
|
|
26
|
+
Follow the prompts to select your tools. That's it!
|
|
27
|
+
|
|
28
|
+
## What's Inside?
|
|
29
|
+
|
|
30
|
+
We support configuration for the following tools:
|
|
31
|
+
|
|
32
|
+
| Feature | Description |
|
|
33
|
+
| :--- | :--- |
|
|
34
|
+
| ๐ถ **Husky** | Robust git hooks to ensure quality before commits. |
|
|
35
|
+
| ๐
**Formatter** | **Prettier** or **Biome** (coming soon) for consistent code style. |
|
|
36
|
+
| ๐งน **Linter** | **ESLint** configured with modern best practices. |
|
|
37
|
+
| ๐ซ **Lint-staged** | Run linters/formatters only on changed files. Fast. |
|
|
38
|
+
| ๐ณ **Env Validation** | Type-safe environment variables with **@t3-oss/env**. |
|
|
39
|
+
| ๐งช **Testing** | Ready-to-go **Vitest** configuration. |
|
|
40
|
+
| โ๏ธ **EditorConfig** | Consistent coding styles between different editors. |
|
|
41
|
+
| ๐ **License** | Generate standard MIT, Apache, or ISC licenses instantly. |
|
|
42
|
+
|
|
43
|
+
## Advanced Usage
|
|
44
|
+
|
|
45
|
+
### Manage Plugins
|
|
46
|
+
|
|
47
|
+
Want to add plugins to your existing tools?
|
|
48
|
+
|
|
49
|
+
```bash
|
|
50
|
+
npx @mayrlabs/setup-project plugin
|
|
51
|
+
```
|
|
52
|
+
|
|
53
|
+
This will guide you through adding plugins to ESLint or Prettier (e.g., `prettier-plugin-tailwindcss`).
|
|
54
|
+
|
|
55
|
+
### Configure Single Tool
|
|
56
|
+
|
|
57
|
+
Just need to set up one thing?
|
|
58
|
+
|
|
59
|
+
```bash
|
|
60
|
+
npx @mayrlabs/setup-project configure husky
|
|
61
|
+
```
|
|
26
62
|
|
|
27
|
-
##
|
|
63
|
+
## Contributing
|
|
28
64
|
|
|
29
|
-
|
|
30
|
-
2. **Survey**: Asks you which tools you want to set up and collects your preferences.
|
|
31
|
-
3. **Summary**: Shows a summary of the actions to be taken.
|
|
32
|
-
4. **Execution**: Installs dependencies and creates configuration files tailored to your choices.
|
|
65
|
+
We love contributions! If you're looking to help improve this package (add new tools, fix bugs), please check out our [Contributing Guide](./CONTRIBUTING.md).
|
|
33
66
|
|
|
34
67
|
## License
|
|
35
68
|
|