A project's source usually lives in folders — src/, docs/, tests/. When you pick files in a browser, only their names are sent, so the folders are lost. The easy way to keep them: put the project in one .zip and upload that.

How to do it

1. Zip your project folder on your computer.
2. Open your project's Upload files page (from the project page, or Files on My projects).
3. Pick or drop the one .zip file. The box Unpack a .zip into its folders and files appears, already ticked.
4. Choose the version under Attach to version and press Upload files.

The files in the archive become the browsable source of that version, folders and all. Readers see them on the project's Source tab, and the success message counts the files that were unpacked. The archive's top folder is kept as it is, so a zip of myapp/ shows up under myapp/.

Keeping the .zip as one file

• Untick the box to upload the .zip itself as a single file.
• Unpacking only happens for exactly one .zip. A .zip picked together with other files is always kept as a file, and the box is hidden for such picks.

What is checked

• A path inside the archive that is absolute or climbs out with .. refuses the whole upload.
• The same path twice is refused, and one upload can hold up to 5000 files.
• Your free storage is checked against the unpacked size before anything is extracted.
• The __MACOSX/ folder that macOS adds to archives is skipped.
• If the archive cannot be opened — damaged, or a password-protected file inside — you get a message saying so, and nothing is stored.

As with any upload here, the new files replace the source stored for that version.

More on source files: Upload your project's source files and Check your files before you upload. More guides at https://jmtechpower.com/articles.