|
1 | | -# starter-template-vue-bootstrap-sass-typescript |
| 1 | +# Starter template based on Vue 3, Bootstrap 5, SASS and Typescript |
2 | 2 |
|
3 | | -This template should help get you started developing with Vue 3 in Vite. |
| 3 | +This template should help get you started developing with Vue 3 in Vite and Bootstrap 5 with SASS. |
4 | 4 |
|
5 | | -## Recommended IDE Setup |
| 5 | +## Frameworks |
6 | 6 |
|
7 | | -[VSCode](https://code.visualstudio.com/) + [Volar](https://marketplace.visualstudio.com/items?itemName=Vue.volar) (and disable Vetur) + [TypeScript Vue Plugin (Volar)](https://marketplace.visualstudio.com/items?itemName=Vue.vscode-typescript-vue-plugin). |
| 7 | +- [VueJS](https://vuejs.org/guide/quick-start.html) |
| 8 | +- [Bootstrap](https://getbootstrap.com/docs/5.3/getting-started/introduction/) |
8 | 9 |
|
9 | | -## Type Support for `.vue` Imports in TS |
| 10 | +## Supported preprocessors |
10 | 11 |
|
11 | | -TypeScript cannot handle type information for `.vue` imports by default, so we replace the `tsc` CLI with `vue-tsc` for type checking. In editors, we need [TypeScript Vue Plugin (Volar)](https://marketplace.visualstudio.com/items?itemName=Vue.vscode-typescript-vue-plugin) to make the TypeScript language service aware of `.vue` types. |
| 12 | +- [TypeScript](https://www.typescriptlang.org/docs/handbook/intro.html) |
| 13 | +- [SASS](https://sass-lang.com/documentation/) |
12 | 14 |
|
13 | | -If the standalone TypeScript plugin doesn't feel fast enough to you, Volar has also implemented a [Take Over Mode](https://github.com/johnsoncodehk/volar/discussions/471#discussioncomment-1361669) that is more performant. You can enable it by the following steps: |
| 15 | +## Additional packages |
14 | 16 |
|
15 | | -1. Disable the built-in TypeScript Extension |
16 | | - 1) Run `Extensions: Show Built-in Extensions` from VSCode's command palette |
17 | | - 2) Find `TypeScript and JavaScript Language Features`, right click and select `Disable (Workspace)` |
18 | | -2. Reload the VSCode window by running `Developer: Reload Window` from the command palette. |
| 17 | +- [Bootstrap Icons](https://icons.getbootstrap.com/) |
| 18 | +- [Vue Router](https://router.vuejs.org/guide/) |
| 19 | +- [Process Environment](https://vitejs.dev/guide/env-and-mode.html) |
19 | 20 |
|
20 | | -## Customize configuration |
| 21 | +## Builder |
21 | 22 |
|
22 | | -See [Vite Configuration Reference](https://vitejs.dev/config/). |
| 23 | +- [Vite](https://vitejs.dev/guide/) |
23 | 24 |
|
24 | | -## Project Setup |
| 25 | +## Developer notes |
25 | 26 |
|
26 | | -```sh |
27 | | -npm install |
28 | | -``` |
29 | | - |
30 | | -### Compile and Hot-Reload for Development |
31 | | - |
32 | | -```sh |
33 | | -npm run dev |
34 | | -``` |
| 27 | +There are two different layouts (Default and Page) — first one for the home page and another for the rest. Layouts are changed based on [Nested Named Routes](https://router.vuejs.org/guide/essentials/nested-routes.html#nested-named-routes) in Vue Router. This way does not use dynamic imports and works faster. |
35 | 28 |
|
36 | | -### Type-Check, Compile and Minify for Production |
| 29 | +## Directory structure |
37 | 30 |
|
38 | | -```sh |
39 | | -npm run build |
40 | 31 | ``` |
| 32 | +├───public |
| 33 | +│ favicon.ico |
| 34 | +│ |
| 35 | +└───src |
| 36 | + │ App.vue |
| 37 | + │ main.ts |
| 38 | + │ |
| 39 | + ├───components |
| 40 | + │ Footer.vue |
| 41 | + │ Heads.vue |
| 42 | + │ Nav.vue |
| 43 | + │ Refs.vue |
| 44 | + │ |
| 45 | + ├───layouts |
| 46 | + │ Default.vue |
| 47 | + │ Page.vue |
| 48 | + │ |
| 49 | + ├───router |
| 50 | + │ index.ts |
| 51 | + │ |
| 52 | + └───views |
| 53 | + About.vue |
| 54 | + Contacts.vue |
| 55 | + Home.vue |
| 56 | +``` |
0 commit comments