BRAND.md

Brand SyncBay

Questo documento definisce l'identità di base di SyncBay. Va aggiornato quando cambiano nome, posizionamento, tono, palette, logo direction o messaggi pubblici.

Sintesi

SyncBay è una Shopify app per negozianti italiani che vogliono portare il catalogo del proprio negozio eBay.it su Shopify in modo ordinato, sincronizzato e con meno rischio di vendere prodotti non disponibili.

La marca deve comunicare:

• controllo;
• chiarezza;
• continuità tra canali;
• sicurezza operativa;
• meno lavoro manuale.

Non deve sembrare:

• una suite marketplace enorme;
• un gestionale ecommerce generico;
• un'app che copia o imita i brand eBay o Shopify;
• un tool tecnico solo per sviluppatori;
• un servizio che richiede supporto umano continuo.

Nome

Nome prodotto: SyncBay

Razionale:

• Sync comunica allineamento, automazione e continuità.
• Bay richiama in modo sottile il punto di partenza eBay senza usare "eBay" nel nome.
• Il nome è corto, internazionale e SaaS-friendly.

Nota legale/brand: prima di app pubblica, dominio, marchio o listing Shopify App Store, verificare collisioni e policy di uso marchi eBay/Shopify. Non presentare SyncBay come app ufficiale eBay o Shopify se non esiste approvazione esplicita.

Tagline

Tagline principale:

Dal tuo negozio eBay a Shopify, pronto a vendere.

La tagline precedente "Da eBay a Shopify, senza rifare tutto." è scartata.

Razionale:

• nomina eBay e Shopify, ma come contesto naturale e non come imitazione dei brand;
• usa "negozio eBay" per l'origine;
• usa "catalogo Shopify" per la destinazione;
• linguaggio immediato per negozianti italiani;
• taglio commerciale, con focus su vendibilità e trasformazione del catalogo.

Uso:

• landing pubblica;
• Shopify App Store listing;
• materiali introduttivi;
• prima schermata onboarding.

Tagline secondarie:

• Catalogo allineato, schede ordinate, disponibilità sotto controllo.
• Meno lavoro manuale tra negozio e catalogo Shopify.
• Il tuo negozio eBay diventa un catalogo Shopify ordinato.

Promessa prodotto

Formula breve:

SyncBay porta il tuo negozio eBay in un catalogo Shopify ordinato, con schede pronte a vendere, disponibilità sincronizzate e meno rischio di vendere prodotti non disponibili.

Formula estesa:

SyncBay aiuta i negozianti che vendono già su eBay.it a creare o alimentare un catalogo Shopify senza ricreare manualmente schede prodotto, immagini, prezzi e quantità. Il negozio eBay resta il punto di partenza; Shopify riceve un catalogo controllato, con descrizioni pulite, prezzi specifici per canale, conflitti visibili e disponibilità protette.

Posizionamento

Categoria:

• Shopify app per trasformare un negozio eBay.it in un catalogo Shopify sincronizzato.

Target iniziale:

• negozianti italiani che vendono già su eBay.it;
• venditori con catalogo fino a 2.000 prodotti nel MVP;
• negozianti che vogliono aprire Shopify partendo dal negozio eBay già esistente;
• venditori che non vogliono gestire subito una piattaforma marketplace bidirezionale complessa.

Differenziazione:

• richiamo sottile ma riconoscibile a eBay.it come punto di partenza;
• Shopify come catalogo ordinato e controllato;
• anteprima e ripristino prima di fare danni;
• conflitti visibili invece di sovrascritture cieche;
• diagnostica self-service invece di supporto umano come pilastro;
• disponibilità protette anche se la sincronizzazione catalogo resta principalmente in una direzione.

Personalità

SyncBay deve sembrare:

• preciso;
• calmo;
• affidabile;
• pratico;
• orientato al negoziante;
• trasparente sugli errori.

Non deve sembrare:

• rumoroso;
• aggressivo;
• troppo "growth hacking";
• troppo enterprise;
• troppo tecnico;
• ansioso o allarmista.

Tono di voce

Lingua default: italiano. Il target iniziale è italiano, quindi UI, microcopy, documentazione prodotto e materiali pubblici devono evitare inglesismi quando esiste un'alternativa chiara.

Registro:

• "tu" professionale;
• frasi brevi;
• verbi concreti;
• niente esclamativi multipli;
• niente emoji nella UI;
• niente "Oops";
• niente promesse assolute non garantite.

Esempi:

Situazione	Buono	Evitare
Sincronizzazione completata	128 prodotti aggiornati.	Tutto perfetto!
Errore immagine	Questa immagine non è scaricabile da eBay. Puoi riprovare o continuare senza importarla.	Oops, qualcosa è andato storto.
Conflitto	Il prezzo è stato modificato su Shopify dopo l'ultima sincronizzazione. Scegli quale valore mantenere.	Abbiamo trovato un problema.
Disponibilità critica	Non siamo riusciti ad aggiornare la quantità sul marketplace. Il prodotto resta in modalità prudente.	Errore grave di sistema.

Messaggi chiave

Per landing/App Store

• Importa dal negozio eBay con anteprima prima di scrivere sul catalogo Shopify.
• Mantieni prezzi, quantità, immagini e descrizioni allineati.
• Pulisci le descrizioni eBay dai template pesanti.
• Applica prezzi specifici per Shopify senza modificare il marketplace di partenza.
• Proteggi le disponibilità per ridurre il rischio di vendere prodotti non disponibili.
• Risolvi conflitti ed errori dalla dashboard.

Per dashboard

• Stato sincronizzazione chiaro.
• Prossima azione sempre visibile.
• Errori leggibili.
• Riprova sicura dove possibile.
• Nessuna sovrascrittura silenziosa.
• Conflitti classificati per rischio: batch sicuro solo quando non cambia prezzo, disponibilità, stato prodotto o mapping.
• Retry spiegato con impatto sul prodotto, prossima azione e riferimento tecnico, senza scaricare sul negoziante dettagli interni inutili.

Per screenshot prodotto

• Usare dati reali o fixture sintetiche realistiche, mai dati personali o listing di negozianti non autorizzati.
• Mostrare le sei superfici embedded solo quando sono coerenti con dati reali: Panoramica, Catalogo, Conflitti, Importazione, Attività, Impostazioni.
• Preferire schermate con azione successiva chiara: conflitti classificati, retry sicuro, import pronto o catalogo aggiornato.
• Evitare screenshot dove SyncBay sembra una suite marketplace bidirezionale, un prodotto ufficiale eBay/Shopify o un support desk umano.

Per pagine tecniche/docs

• Il negozio eBay resta la fonte principale.
• Shopify riceve un catalogo pulito e vendibile.
• Sincronizzazione entro 5 minuti come garanzia base.
• Real-time dove possibile e sostenibile.

Visual direction

Principi

• Interfaccia SaaS operativa, non marketing decorativo.
• Layout denso ma leggibile.
• Dashboard da lavoro quotidiano, non hero page generica.
• Colori sobri con accenti funzionali.
• Richiamo cromatico a eBay/Shopify controllato: riconoscibile, ma non ufficiale o imitativo.
• Evitare gradienti dominanti, orbs, bokeh o decorazione astratta.

Palette logo definitiva

Ruolo	Nome	Valore
Ponte e Bay	Bay Blue	#0064D2
Sync	Sync Green	#95BF47
Stanghetta gialla	Listing Yellow	#F5AF02
Stanghetta rossa	Listing Red	#E53238
Testo secondario	Slate	#51615F
Sfondo	White	#FFFFFF

Regole:

• il blu e il verde richiamano eBay e Shopify senza usare loghi, forme proprietarie o claim di ufficialità;
• Sync usa il verde, Bay usa il blu;
• il ponte usa il blu;
• le stanghette sopra il ponte usano solo verde, giallo e rosso;
• non aggiungere blu nelle stanghette, perché il blu è già usato dal ponte;
• non usare il logo in modo da far sembrare SyncBay un'app ufficiale eBay o Shopify.

Palette direzionale

In implementazione progressiva nel design layer (ADR 0010). Distinta dagli asset logo definitivi.

La palette semantica usa i colori del logo eBay/Shopify (ADR 0013): il verde di Shopify sostituisce il verde di eBay. Brand primario = blu eBay, secondario = verde Shopify. Ogni ruolo semantico ha hue di marca (bordi/icone/accenti), tinta tenue (sfondi) e versione scura per il testo.

Ruolo	Nome	Hue	Testo	Tinta
Fondo app	Cloud	#F6F8F7	—	—
Superficie	Paper	#FFFFFF	—	—
Testo primario	Ink	#15202B	—	—
Testo secondario	Slate	#51615F	—	—
Bordo	Mist	#D8E0DD	—	—
Primario / Accento / Info	Bay Blue (eBay)	#0064D2	#0A4A94	#E7F0FB
Secondario / Successo	Verde Shopify	#95BF47	#466A1A	#EEF6E1
Warning	Giallo eBay	#F5AF02	#7A5200	#FDF3D6
Errore / Conflitto	Rosso eBay	#E53238	#A31D22	#FCE9EA
Legacy (no ruolo)	Harbor / Current	#0F5E6E / #1A8F7A	—	—

Regole:

• Mappatura semantica = colori eBay/Shopify: success = verde Shopify, info = blu eBay, warning = giallo eBay, errore = rosso eBay. Vedi ADR 0013.
• Blu = primario E info: stessa tinta, trattamento diverso — il primario/ azione usa il blu pieno (link, battito, sparkline, focus, bottoni primari), l'informativo usa la tinta tenue + testo blu scuro.
• Contrasto: gli hue di marca da soli non bastano come testo su bianco; usare sempre la variante -text scura per il testo e tenere le superfici neutre.
• Colore di marca su accenti, icone, badge e bordi — mai come campiture diffuse o banner che ricreino il logo eBay.
• Harbor/Current restano colori legacy, senza ruolo semantico.
• Tema chiaro, ma theme-ready: colori come variabili semantiche, nessun dark mode spedito (admin Shopify light-only). Vedi ADR 0013.

Tipografia

Direzione consigliata:

• sans moderna e leggibile per UI;
• numeri tabulari per metriche, disponibilità, prezzi e conteggi operativi;
• pesi medi, non eccessivamente bold;
• niente display font ornamentali.

Possibili famiglie future:

• Geist Sans / Geist Mono se lo stack resta Vercel-friendly;
• Inter / Inter Tight se serve massima compatibilità.

La scelta finale va fissata quando nasce il design system.

Logo definitivo

Logo approvato: Catalog Bridge.

Composizione:

• icona a ponte con stanghette verticali sopra;
• Sync in verde;
• Bay in blu;
• ponte in blu;
• stanghette solo verdi, gialle e rosse;
• tagline sotto al combinato principale.

Asset:

• riferimento approvato: brand/assets/source/syncbay-logo-approved-reference.png;
• SVG con tagline: brand/assets/svg/syncbay-logo-horizontal-tagline.svg;
• logo orizzontale senza tagline: brand/assets/svg/syncbay-logo-horizontal.svg;
• combinato verticale: brand/assets/svg/syncbay-logo-stacked-tagline.svg;
• wordmark: brand/assets/svg/syncbay-wordmark.svg;
• icona quadrata: brand/assets/svg/syncbay-icon-square.svg;
• icona navigazione Shopify: brand/assets/svg/syncbay-navigation-icon.svg;
• export PNG: brand/assets/png/;
• favicon: brand/assets/favicon/favicon.ico;
• manifest: brand/assets/manifest.json.

Regole:

• usare il PNG approvato in brand/assets/source/ come source of truth visiva;
• gli asset sono rigenerati con colori pieni sulla palette logo definitiva, per evitare componenti sbiaditi o non uniformi nei PNG trasparenti;
• gli SVG logo attuali sono wrapper raster fedeli, non tracciati vettoriali puri modificabili punto per punto;
• l'icona navigazione Shopify è un tracciato vettoriale puro 16x16, monocromatico e con sfondo trasparente;
• per stampa, deposito marchio o requisiti App Store che richiedano vettoriale puro, creare una versione tracciata in un tool di design partendo dal riferimento approvato;
• preferire SVG o PNG trasparenti dove possibile, secondo il contesto di utilizzo;
• usare PNG trasparenti per UI e documenti su sfondi controllati;
• usare le versioni png/white/ quando serve uno sfondo bianco già incorporato;
• non alterare proporzioni, ordine cromatico o tagline;
• non usare loghi ufficiali eBay/Shopify accanto al logo SyncBay senza verifica policy.

UI brand rules

• Prima schermata app: dashboard o onboarding operativo, non landing marketing.
• Ogni pagina deve avere scopo chiaro: stato, azione, errore o configurazione.
• Le card vanno usate per entità ripetute, job, conflitti o pannelli funzionali; evitare card dentro card.
• I conflitti devono essere visivamente distinti dagli errori tecnici.
• Gli stati di disponibilità critica devono avere priorità visiva maggiore degli aggiornamenti descrizione/immagini.
• Usare icone solo dove aiutano la scansione, non come decorazione.

Naming superfici

Nomi UI preferiti:

• Dashboard
• Connessioni
• Import
• Sincronizzazione
• Prodotti
• Conflitti
• Errori
• Regole prezzo
• Descrizioni
• Impostazioni

Da evitare nel MVP:

• Marketplace Center
• Omnichannel Suite
• AI Catalog Manager
• Support Center
• Growth Hub

Claim da evitare

• "Real-time garantito" se non è tecnicamente garantito.
• "Zero vendite oltre disponibilità" come promessa assoluta.
• "App ufficiale eBay/Shopify" senza approvazione.
• "Import illimitato" nel MVP.
• "Sincronizzazione bidirezionale" per descrivere il prodotto MVP.

Asset

Asset già creati:

• logo SVG;
• favicon/app icon;
• export PNG ad alta definizione;
• combinati orizzontali e verticali;
• icona quadrata solo ponte;
• varianti PNG con sfondo trasparente e bianco.

Asset futuri prima del listing pubblico:

• screenshot dashboard;
• screenshot onboarding;
• screenshot conflitti/errori;
• eventuale one-pager App Store.