|
1 |
| -# create-vue |
| 1 | +# Create Vue Fork |
2 | 2 |
|
3 |
| -The recommended way to start a Vite-powered Vue project |
| 3 | +TODO - Update github related stuff when transferred |
4 | 4 |
|
5 |
| -<p align="center"> |
6 |
| - <img src="https://github.com/vuejs/create-vue/blob/main/media/screenshot-cli.png?raw=true" width="800"> |
7 |
| -</p> |
| 5 | +This is a fork of the <a href="https://github.com/vuejs/create-vue">create-vue</a>, where we are extending its existing functionality while keeping it up to date with the original repository. Feel free to contribute and help make this project even better! |
8 | 6 |
|
9 |
| -## Usage |
| 7 | +## Getting Started |
10 | 8 |
|
11 |
| -```sh |
12 |
| -npm create vue@latest |
| 9 | +Follow these steps to clone, build, and run the project: |
| 10 | + |
| 11 | +### 1. Clone the Repository |
| 12 | + |
| 13 | +```bash |
| 14 | +git clone https://github.com/your-username/vite-cli-bootstrap.git |
| 15 | +cd vite-cli-bootstrap |
13 | 16 | ```
|
14 | 17 |
|
15 |
| -Or, if you need to support IE11, you can create a Vue 2 project with: |
| 18 | +### 2. Install Dependencies |
| 19 | + |
| 20 | +Make sure you have <a href="https://pnpm.io/">pnpm</a> installed, as we'll be using it for package management. |
16 | 21 |
|
17 |
| -```sh |
18 |
| -npm create vue@legacy |
| 22 | +```bash |
| 23 | +pnpm install |
19 | 24 | ```
|
20 | 25 |
|
21 |
| -Note that the tag name (`@latest` or `@legacy`) MUST NOT be omitted, otherwise `npm` may resolve to a cached and outdated version of the package. |
| 26 | +### 3. Build the Project |
| 27 | + |
| 28 | +To build the project, run the following command: |
| 29 | + |
| 30 | +```bash |
| 31 | +pnpm run build |
| 32 | +``` |
| 33 | + |
| 34 | +This will generate the build output in the outfile.cjs file. |
| 35 | + |
| 36 | +### 4. Run the Project |
| 37 | + |
| 38 | +You can now use the built CLI by running the following command, replacing <path-to-build-file> with the actual path to the outfile.cjs file: |
| 39 | + |
| 40 | +```bash |
| 41 | +npx <path-to-build-file> |
| 42 | +``` |
| 43 | + |
| 44 | +--- |
| 45 | + |
| 46 | +## Contribution |
| 47 | + |
| 48 | +We welcome contributions to make this project better. Please use the following methods for discussions, reporting issues, and contributing code: |
| 49 | + |
| 50 | +### 1. Issues |
| 51 | + |
| 52 | +If you encounter any problems or have suggestions, please open an issue here. |
| 53 | + |
| 54 | +### 2. Discussions |
22 | 55 |
|
23 |
| -## Difference from Vue CLI |
| 56 | +For broader discussions, questions, or feature requests, you can use the Discussions section. |
24 | 57 |
|
25 |
| -- Vue CLI is based on webpack, while `create-vue` is based on [Vite](https://vitejs.dev/). Vite supports most of the configured conventions found in Vue CLI projects out of the box, and provides a significantly better development experience due to its extremely fast startup and hot-module replacement speed. Learn more about why we recommend Vite over webpack [here](https://vitejs.dev/guide/why.html). |
| 58 | +### 3. Pull Requests |
26 | 59 |
|
27 |
| -- Unlike Vue CLI, `create-vue` itself is just a scaffolding tool: it creates a pre-configured project base on the features you choose, and delegates the rest to Vite. Projects scaffolded this way can directly leverage the [Vite plugin ecosystem](https://vitejs.dev/plugins/) which is Rollup-compatible. |
| 60 | +If you'd like to contribute code, please follow these steps: |
28 | 61 |
|
29 |
| -## Migrating from Vue CLI |
| 62 | +- Create a new branch for your changes: git checkout -b feature/your-feature-name. |
| 63 | +- Make your changes and commit them. |
| 64 | +- Push your changes to your branch. |
| 65 | +- Create a pull request (PR) from your branch to the main branch of this repository. |
30 | 66 |
|
31 |
| -- [Vue CLI -> Vite Migration Guide from VueSchool.io](https://vueschool.io/articles/vuejs-tutorials/how-to-migrate-from-vue-cli-to-vite/) |
| 67 | +Please ensure your code follows the existing code style and includes necessary tests if applicable. |
32 | 68 |
|
33 |
| -- [Tools / Plugins that help with auto migration](https://github.com/vitejs/awesome-vite#vue-cli) |
| 69 | +Thank you for contributing to the project! |
0 commit comments