DOCS SMARTSPEC / INSTALL

Installazione

Tre modi per installare SmartSpec. Scegli quello che si adatta al tuo workflow.

RACCOMANDATO

Via npm globale

Il modo più semplice se hai già Node.js 20 o superiore.

npm install -g smartspec
smartspec --version

smartspec --version
smartspec doctor
smartspec audit https://example.com -m 1

Se smartspec doctor passa e l'audit produce score: 59 circa, tutto funziona.

Limita l'audit a un singolo modulo con --only. Output in markdown su file.

smartspec audit https://mio-sito.app --only schema -f markdown -o schema.md

Combinabile: --only schema,performance. Vedi tutti i flag →

macOS 12+, Linux (glibc o musl)

Architettura

x64, arm64

Node.js

20+

PageSpeed API key

Opzionale (var GOOGLE_PSI_API_KEY)

command not found: smartspec

Verifica che la npm bin globale sia nel $PATH. Lancia npm bin -g per scoprire il path.

permission denied su npm install -g

Usa un Node version manager (nvm, fnm, volta) invece di installare Node globale come root. Evita sudo npm.

PSI non funziona (performance: null nei finding)

Senza API key, la PSI v5 ha quota molto bassa. Genera una key da Google Developer Console e esportala come GOOGLE_PSI_API_KEY.

Vedi tutti i moduli, formati di output, integrazioni.