2.2.0 • Published 3 years ago

@tryharddood/ngx-tailwind v2.2.0

Weekly downloads
-
License
MIT
Repository
github
Last release
3 years ago

Tailwind CSS Schematics

npm version Schematics CI

Simple Angular schematic initializing Tailwind CSS in your project. Angular v11.2 includes native support for Tailwind CSS.

Only works with Angular v11.2 and up.

Installation

Run

npm install https://github.com/TryHardDood/ngx-tailwind
yarn add https://github.com/TryHardDood/ngx-tailwind
ng generate ngx-tailwind:ng-add

# or

npm install https://github.com/TryHardDood/ngx-tailwind
yarn add https://github.com/TryHardDood/ngx-tailwind
ng generate ngx-tailwind:ng-add --project <MY_PROJECT>

Example output

? Which stylesheet format are you using? SCSS [ https://sass-lang.com/documentation/syntax#scss ]
? Which @tailwindcss plugins do you want to install? aspect-ratio, forms, line-clamp, typography
CREATE tailwind.config.js (360 bytes)
CREATE scripts/ngx-tailwind-jit-transform.js (367 bytes)
UPDATE package.json (1782 bytes)
UPDATE src/styles.scss (97 bytes)
√ Packages installed successfully.

Migrate from Tailwind CSS v1 to v2

To upgrade you project from Tailwind CSS v1.x to v2.0 run the following install command

npm i -D tailwindcss@latest autoprefixer@latest postcss@latest postcss-import@latest postcss-loader@latest

# using scss
npm i -D postcss-scss@latest

Read the full Upgrade Guide to update your custom tailwind.config.js (e.g. your color palette) and replace removed classes from your template (e.g. shadow-outline and shadow-xs).

All available flags:

Flag DescriptionType Default
 cssFormatThe file extension or preprocessor to use for style files.css |  scsscss
 projectThe project to initialize with Tailwind CSS.stringFirst Angular project
 postcssVersionThe postcss version to be installed.string^8.2.6
 skipTailwindInitSkip initializing Tailwind.booleanfalse
 tailwindVersionThe Tailwind version to be installed.string^2.0.3
 disableCrossPlatformSet the build:prod script to be only UNIX compatible.booleanfalse
 crossEnvVersionThe cross-env version to be installed.string^7.0.3
 tailwindPlugins@tailwindcss plugins installed and added to tailwind.config.jsstring[]aspect-ratio, forms, line-clamp, typography

Developing

Install @angular-devkit/schematics-cli to be able to use schematics command

npm i -g @angular-devkit/schematics-cli

Now build the schematics and run the schematic.

npm run build
# or
npm run build:watch

# dry-run in angular-workspace
npm run start:dev

# execute schematics in angular-workspace
npm run start