Skip to content

Commit c225b4f

Browse files
committed
UPD: Readme
1 parent ba3680f commit c225b4f

File tree

5 files changed

+64
-32
lines changed

5 files changed

+64
-32
lines changed

README.md

Lines changed: 42 additions & 26 deletions
Original file line numberDiff line numberDiff line change
@@ -1,40 +1,56 @@
1-
# starter-template-vue-bootstrap-sass-typescript
1+
# Starter template based on Vue 3, Bootstrap 5, SASS and Typescript
22

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

5-
## Recommended IDE Setup
5+
## Frameworks
66

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/)
89

9-
## Type Support for `.vue` Imports in TS
10+
## Supported preprocessors
1011

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/)
1214

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
1416

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)
1920

20-
## Customize configuration
21+
## Builder
2122

22-
See [Vite Configuration Reference](https://vitejs.dev/config/).
23+
- [Vite](https://vitejs.dev/guide/)
2324

24-
## Project Setup
25+
## Developer notes
2526

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

36-
### Type-Check, Compile and Minify for Production
29+
## Directory structure
3730

38-
```sh
39-
npm run build
4031
```
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+
```

package.json

Lines changed: 22 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,26 @@
11
{
2-
"name": "starter-template-vue-bootstrap-sass-typescript",
3-
"version": "0.0.0",
4-
"private": true,
2+
"name": "@howbizarre/starter-template-vue-bootstrap-sass-typescript",
3+
"version": "1.0.1",
4+
"description": "This boilerplate is based on Vue 3 with Bootstrap 5 with TypeScript support. Bootstrap Icons and Vue Router have also been added.",
5+
"homepage": "https://bizarre.how/vue-bootstrap/",
6+
"license": "CC-BY-4.0",
7+
"repository": "github:@howbizarre/starter-template-vue-bootstrap-sass-typescript",
8+
"author": "How Bizarre <how.bizarre@gmail.com>",
9+
"keywords": [
10+
"vue",
11+
"bootstrap",
12+
"typescript",
13+
"boilerplate",
14+
"template",
15+
"javascript",
16+
"vuejs",
17+
"node",
18+
"component",
19+
"starter",
20+
"vue3",
21+
"bootstrap5",
22+
"sass"
23+
],
524
"scripts": {
625
"dev": "vite",
726
"build": "run-p type-check build-only",

src/components/Nav.vue

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -64,7 +64,6 @@ import { useRouter } from "vue-router";
6464
import { routes } from "@/router";
6565
6666
const siteUrl = import.meta.env.VITE_BUILD_ADDRESS;
67-
6867
const router = useRouter();
6968
const activeRoute = computed(() => router.currentRoute.value.path);
7069
const isActive = (path: string) => path === activeRoute.value;

tsconfig.json

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,6 @@
77
"@/*": ["./src/*"]
88
}
99
},
10-
1110
"references": [
1211
{
1312
"path": "./tsconfig.config.json"

vite.config.ts

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,4 @@
11
import { fileURLToPath, URL } from "node:url";
2-
32
import { defineConfig } from "vite";
43
import vue from "@vitejs/plugin-vue";
54

0 commit comments

Comments
 (0)