test-nuxt-static

0

Описание

Nuxt3 boilerplate with Tailwind3

Языки

  • JavaScript45,2%
  • Vue29,7%
  • CSS25,1%
3 года назад
3 года назад
3 года назад
3 года назад
README.md

Infos

A quick template with all the basics needed to jumpstart a new project ⚡

What's in the box 🎁

  • Nuxt 3.x (latest)
  • TailwindCSS 3 (with PostCSS)
  • A default page & layout
  • Global style sheet
  • Some maybe useful components

Process

Creating a new Page

Create a new Vue file in

/pages
folder. The name of the file is also use for its path. For example,
/pages/foo/bar.vue
will be resolved as
www.website.com/foo/bar.html

💡 More info here : nuxt.com/docs/getting-started/views#pages

Using Components

Calling a component should be done as follows:

/components/utils/FancyButton.vue
should be called with
<utils-fancy-button></utils-fancy-button>

💡 More info here : nuxt.com/docs/getting-started/views#components

Style

Global Style Sheet

The global style sheet is a postcss file in

/assets/css/base.postcss

You can write and use basic CSS but prefer using
@apply
with Tailwind properties.
💡 All Tailwind properties here : tailwindcss.com/docs

Component Style

In-component style should be written using PostCSS and

@apply
to re-use Tailwind property as much as possible (also know as Atomic CSS).
Inside your component use the
style
tag as follows:

📝 Note:

scoped
means your style won't leak into other components. Very usefull for Layouts components.
💡 More info here : vue-loader.vuejs.org/guide/scoped-css.html

Custom Tailwind Config

You can override or add new properties for Tailwind inside its config file

/tailwind.config.js

Layouts

💨 nuxt.com/docs/getting-started/views#layouts

Static vs Assets

To make things simple. Assets inside the

/assets
folder will be proccesed by some webpack module, like
base.postcss
for example. It can be images, JSON files,... Outputted files will have hashed name to facilitate cache management.
On the opposite side,
/static
files will be served as it is with no hash or handling whatsoever.

Tailwind Autocomplete

💨 https://tailwindcss.nuxtjs.org/tailwind/editor-support/

Building