https://github.com/windicss/windicss-analysis

🔍 A visual analyzer for Windi CSS
https://github.com/windicss/windicss-analysis

analyzer design-system windcss

Last synced: about 1 month ago
JSON representation

🔍 A visual analyzer for Windi CSS

• Host: GitHub
• URL: https://github.com/windicss/windicss-analysis
• Owner: windicss
• License: mit
• Created: 2021-03-29T11:22:59.000Z (over 3 years ago)
• Default Branch: main
• Last Pushed: 2022-09-26T18:32:26.000Z (almost 2 years ago)
• Last Synced: 2024-05-22T16:23:58.102Z (4 months ago)
• Topics: analyzer, design-system, windcss
• Language: TypeScript
• Homepage: https://analysis-demo.windicss.org
• Size: 185 KB
• Stars: 129
• Watchers: 9
• Forks: 7
• Open Issues: 15
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Windi Analysis

An analyser tool for [Windi CSS](https://github.com/windicss/windicss). Browse your utilities usages, have an overview of your design system, identify "bad practices", and more!

![](https://user-images.githubusercontent.com/11247099/113150805-0c43f880-9267-11eb-85a6-ec1a2f1eed37.png)

## Get Started

Run the following command under your project root

```bash

npx windicss-analysis

```

The analysis report will be available at http://localhost:8113/

### NPM

Or you can install locally to reuse the same version of your local `windicss` module

```bash

npm i -D windicss-analysis

```

```jsonc

// package.json

{

  "scripts": {

    "analysis": "windicss-analysis"

  }

}

```

### VS Code Extension

From v0.8.0 of [Windi CSS Intellisense](https://github.com/windicss/windicss-intellisense), it has this analyser built-in.

- Open a project using Windi CSS in VS Code

- Open the Command Palette (⇧⌘P / Ctrl+Shift+P)

- Run command: `Windi CSS: Run & Open Analysis`

- See Analyser in the second editor column

### Online Preview

You can have a preview the analysing report of the analyser itself

[analysis-demo.windicss.org](http://analysis-demo.windicss.org)

You can genreate your own report and host it statically by running the following command

```bash

npx windicss-analysis --html dist

```

## FAQ

### It does not detecting my files

You will need to configure the `extract.include` options in `windi.config.js` instead of your framework's configurations file so it can be understood by the analyzer so as other intergations support. For example

```ts

// windi.config.js

import { defineConfig } from 'windicss/helpers'

import colors from 'windicss/colors'

export default defineConfig({

  extract: {

    include: [

      'src/**/*.{vue,jsx,tsx,svelte}',

      'shared/**/*.{vue,ts}',

    ],

  },

})

```

### Can I use the report for other tools?

Yes. You can get the raw json file via the CLI

```bash

npx windicss-analysis --json report.json

```

and process it as you need.

You can also have type support for it via:

```ts

import type { AnalysisReport } from 'windicss-analysis'

import rawReport from './report.json'

const report = rawReport as AnalysisReport

```

### Programmatic Use?

Yes. Just like a normal Node package:

```ts

import { startServer } from 'windicss-analysis'

startServer({ /*...* / })

```

Check out the type decrations for more APIs avaliable.

## License

MIT