Skip to content

Commit 2ca7c66

Browse files
Getting started (#9)
— Add initial readme --- Co-authored-by: yordan.ramchev <[email protected]>
1 parent ca3d69a commit 2ca7c66

File tree

1 file changed

+54
-18
lines changed

1 file changed

+54
-18
lines changed

README.md

Lines changed: 54 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -1,33 +1,69 @@
1-
# create-vue
1+
# Create Vue Fork
22

3-
The recommended way to start a Vite-powered Vue project
3+
TODO - Update github related stuff when transferred
44

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!
86

9-
## Usage
7+
## Getting Started
108

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
1316
```
1417

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.
1621

17-
```sh
18-
npm create vue@legacy
22+
```bash
23+
pnpm install
1924
```
2025

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
2255

23-
## Difference from Vue CLI
56+
For broader discussions, questions, or feature requests, you can use the Discussions section.
2457

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
2659

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:
2861

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.
3066

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.
3268

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

Comments
 (0)