Skip to content
This repository has been archived by the owner on Mar 21, 2023. It is now read-only.

Commit

Permalink
fix: update readme
Browse files Browse the repository at this point in the history
  • Loading branch information
srav001 committed Jul 16, 2022
1 parent 2603ac6 commit f81f885
Showing 1 changed file with 8 additions and 12 deletions.
20 changes: 8 additions & 12 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,28 +1,24 @@
# A Production Ready Starter Template

Well I think the title says it all. This is a starter template aimed to be used at apps that will go into production release. It has eslint, prettier and ionic added to it, so that not only does linting and formatting like most projects but also can be made a mobile app when needed with capacitor.
Well I think the title says it all. This is a starter template aimed to be used at apps that will go into production release. It has eslint, prettier and ionic added to it, so that not only does linting and formatting like most projects but also can be made a mobile app when needed with capacitor. It is opinionated to an extend, but at the same time easy to customize since it has minimal config for all packages.

- `It uses the latest tech in vue ecosystem. For example pinia for store and vite for building.` [Click here for more info](https://twitter.com/youyuxi/status/1464058813649088516?lang=en)

## Why Bootstrap and Tailwind together ?
## New in 1.1.0!

Simple, I think bootstrap's grid is most superior in terms of functionality compared to rest like bulma. At the same time it is easy to use. That is why only the grid system from Bootstrap is used.
- UnoCSS replaces tailwind and bootstrap packages. [Click here for more info](https://github.com/unocss/unocss)
- Routing now works by using file system with the help of `vite-plugin-pages`. [Click here for more info](https://github.com/hannoeru/vite-plugin-pages)

### Then why tailwind also ?

As given in the example you can write all your classes in a stylesheet with `@apply` added to a class and use it. Thus keeping your html clean ( Alot people hate that about tailwind, when your html is filled with classes).

### So then why use Tailwind instead of writing css as it is instead of tailwind classes ?

When there are more than 1 person working on project, maintaining a structure or format for classes and variables can be difficult. By using tailwind classes in your stylesheet ( or directly in your HTML ) it makes it easy. Plus tailwind has excellent documentation.
### Why UnoCSS and bootstrap grid 🤔 ?
UnoCSS is awesome, since it's on-demand ( it offers low bundle size ) while providing access to multiple css utilty class from the likes of tailwind. Bootstrap's grid is included simply because I think bootstrap's grid is most superior in terms of functionality compared to rest like bulma while being easy to use ( Can be removed by deleting file in `src/assets/bootstrap-grid.min.css`).

## Why use this template ?

- You might don't want to go through the hassle of setting up linter, formatter, router, store etc and still want the [latest vue](https://twitter.com/youyuxi/status/1464058813649088516?lang=en) has to offer ( All of it is setup ).
- If you use the ionic components as your base for components, in future you can build your web app as an android or ios app with capacitor.
- You can remove - all capacitor dependencies from `package.json` and `capacitor.config.js` to get all other features except build a mobile app.
- Eslint for linting and prettier for formatting files ( and yes both work combined without issues ).
- Husky is setup and is being used for commit linting.
- Eslint for linting and prettier for formatting files.
- Vite is used for superior dev experience..

###
Expand All @@ -38,5 +34,5 @@ Note:
```
pnpm project-setup: 'Runs pnpm install and setups up husky for commit linting'
pnpm lint: 'Runs eslint in src directory and fixes all autofixeable errors'
pnpm format: 'Runs src directory through prettier and formats all files and'
pnpm format: 'Runs src directory through prettier and formats all files'
```

0 comments on commit f81f885

Please sign in to comment.