# DMZ Technology — Design Guidelines

## Brand Overview

DMZ Technology opera nell'automazione industriale. Questa guida traduce l'identità già approvata del sito in regole pratiche per materiali digitali e stampati.

## Brand Personality

Tecnica, precisa, diretta, affidabile e misurata. La credibilità industriale viene prima della decorazione.

## Official Logo Assets

- `dmz-logo`: firma completa DMZ Technology, da preferire quando il brand deve essere identificato per esteso.
- `dmz-mark`: monogramma compatto, da usare solo quando il contesto identifica già chiaramente DMZ Technology.
- Varianti approvate: blu primario, scuro e bianco/reversed. Non modificare geometrie o proporzioni.

## Logo Usage

Usare sempre gli artwork scaricabili. Non ricreare il logo digitando “DMZ Technology”, non deformarlo e non applicare gradienti, contorni o effetti.

## Color Tokens

| Nome | Token | HEX | RGB | Ruolo |
| --- | --- | --- | --- | --- |
| DMZ Blue | `--site-blue` | `#0d47a1` | `rgb(13, 71, 161)` | Colore primario e azioni |
| Industrial Ink | `--site-ink` | `#111c2e` | `rgb(17, 28, 46)` | Testo, superfici scure e hover |
| Technical Surface | `--site-grey` | `#f1f4f8` | `rgb(241, 244, 248)` | Fondi e superfici di supporto |
| Steel Text | `--site-muted` | `#596675` | `rgb(89, 102, 117)` | Testo secondario |
| Precision Border | `--site-border` | `#dfe6ef` | `rgb(223, 230, 239)` | Separatori e controlli |
| White | `#fff` | `#ffffff` | `rgb(255, 255, 255)` | Contrasto e fondi chiari |

## Typography

### DM Sans

Titoli, testo e interfaccia. Pesi tipici 400–700; titoli compatti, testo diretto e leggibile.

### DM Mono

Etichette tecniche e dati brevi. Pesi 400 e 500; evitare paragrafi lunghi.

Il logo è un artwork vettoriale e non va ricreato con un carattere tipografico sostitutivo.

## Layout & Spacing

Usare i container e i breakpoint esistenti. Preferire gerarchie nette, margini coerenti e variazioni di scala; evitare decorazioni usate per riempire spazio.

## Components

Riutilizzare i componenti in `components/site/` e i token in `components/site/site.css`. Pulsanti, focus e stati responsive devono seguire il comportamento esistente.

## Imagery & Photography

Preferire:
- Quadri elettrici e cablaggi reali
- PLC, automazione e macchine industriali
- Dettagli tecnici credibili
- Luce naturale o controllata
- Composizione precisa e ambienti autentici

Evitare:
- Uffici generici e interni in legno
- Ologrammi, neon e interfacce fantascientifiche
- Color grading blu artificiale
- Macchinari o cablaggi irrealistici
- Estetica stock o palesemente generata

## Motion & Interaction

Movimento sobrio, basato su opacity e transform. Ogni animazione deve rispettare `prefers-reduced-motion`; il contenuto non deve dipendere da JavaScript per essere leggibile.

## Accessibility

Contrasto adeguato, focus visibile, HTML semantico, target touch comodi e nessun overflow orizzontale. Testare tastiera e viewport 1440, 1024, 768 e 390 px.

## Copywriting Principles

Scrivere in modo concreto e tecnico. Usare frasi brevi, evitare slogan generici e non inventare clienti, progetti, certificazioni, statistiche o risultati.

## Do / Don't

**Do:** usare asset ufficiali, palette reale, DM Sans, contenuti verificati, immagini industriali credibili e componenti esistenti.

**Don't:** deformare il logo, introdurre nuovi colori, usare neon/ologrammi/gradienti, creare UI SaaS generiche o inventare informazioni aziendali.

## Design Principles

### Credibilità industriale

Prima la correttezza tecnica: immagini, parole e dettagli devono sembrare reali a chi lavora nell’automazione.

### Chiarezza

Una gerarchia forte, messaggi brevi e azioni immediatamente riconoscibili.

### Precisione

Allineamenti, spaziature e stati interattivi devono essere deliberati e coerenti.

### Misura

Pochi colori ed effetti. La qualità nasce da tipografia, contenuto e composizione.

### Coerenza

Riutilizzare token, componenti e regole responsive esistenti prima di introdurre nuove soluzioni.

## AI Prompt — Fotografia industriale

```text
Crea o rifinisci una fotografia industriale realistica per DMZ Technology. Il soggetto deve mostrare quadri elettrici, sistemi PLC, cablaggi di macchina, componenti di automazione o linee produttive in un ambiente tecnico autentico. Usa fotografia professionale, composizione precisa, materiali credibili, luce naturale o controllata e profondità di campo sottile. Mantieni macchinari, cablaggi e componenti tecnicamente plausibili. Evita ologrammi, neon, fantascienza, color grading blu artificiale, scintille elettriche finte, uffici generici, loghi inventati e dettagli tecnici non verificabili. Se è fornita una foto di riferimento, preserva esattamente attrezzature, geometrie e configurazione reale, intervenendo solo su luce, pulizia e composizione.
```

## AI Prompt — Materiali grafici

```text
Progetta un materiale DMZ Technology — presentazione, grafica social, brochure tecnica o documento aziendale — usando esclusivamente gli asset logo ufficiali. Applica DMZ Blue #0d47a1, Industrial Ink #111c2e, Technical Surface #f1f4f8 e i neutri documentati; usa DM Sans per titoli e testo e DM Mono solo per brevi dati tecnici. Mantieni griglia, spaziature e gerarchia coerenti con il sito ufficiale: composizione precisa, forte contrasto, pochi effetti e chiarezza tecnica prima della decorazione. Evita gradienti, glassmorphism, neon, illustrazioni da startup tecnologica e card generiche. Non inventare clienti, progetti, certificazioni, statistiche o capacità aziendali.
```

## AI Prompt — Sviluppo website / UI

```text
Lavora sul sito DMZ Technology come senior design engineer. Ispeziona prima il repository e considera il codice esistente come fonte di verità. Riusa token, font, componenti, contenuti, breakpoint e pattern di interazione già presenti; preserva DM Sans, DM Mono, DMZ Blue #0d47a1 e Industrial Ink #111c2e. Mantieni accessibilità, HTML semantico, focus visibile, performance, responsive e prefers-reduced-motion. Usa Astro per contenuti statici e React solo quando serve stato nel browser. Mantieni le interazioni sobrie ed evita UI SaaS generiche, gradienti, glassmorphism, neon, bento grid e nuove dipendenze non necessarie. Non ridisegnare sezioni non richieste e non inventare informazioni aziendali. Verifica ogni modifica con typecheck, test, build e QA visiva ai breakpoint del progetto.
```
