ZIP guidelines

Technical requirements

• Format: standard .zip (DEFLATE).
• Max size: 500 MB per single file.
• File names in UTF-8 without control characters.
• Max folder depth: 12 levels.

What to include

• A README with installation and dependencies.
• An explicit LICENSE.
• Changelog or release notes.
• Source files and/or pre-compiled binaries for each supported platform.

What to avoid

• Encrypted or password-protected archives.
• Executables that require admin privileges without declaring it.
• Third-party copyrighted material without a license.
• Trackers, malware or miners: our scanner blocks the file.
• Unwanted system files: .DS_Store, Thumbs.db, __MACOSX/, node_modules/, .env with real credentials.

Approved sample structure

A single root folder with the product name, containing documentation, source and (optionally) builds or examples. This is the layout that speeds up approval:

nome-prodotto/
├── README.md            ← descrizione, requisiti, installazione
├── LICENSE              ← licenza esplicita (MIT, GPL, proprietary…)
├── CHANGELOG.md         ← storico versioni
├── package.json         ← (o requirements.txt, composer.json, ecc.)
├── src/                 ← codice sorgente
│   ├── index.ts
│   └── ...
├── dist/                ← build pronta all'uso (opzionale)
│   └── ...
├── examples/            ← esempi d'uso (opzionale)
│   └── demo.html
├── assets/              ← immagini, icone, font (opzionale)
└── docs/                ← documentazione estesa (opzionale)
    └── getting-started.md

Minimum rules accepted: the file must be a valid .zip ≤ 500 MB, with at least a README and a LICENSE at the root of the main folder. Max depth 12 levels, names in UTF-8.