Welcome to the comprehensive guide for uploading files to the Swarm network using our application. This documentation covers all available upload features and options.
- Single File Upload - Basic file upload functionality
- Multiple File Upload - Upload multiple files to the same stamp
- Folder Upload - 🆕 Upload entire directories with auto-generated websites
- ZIP File Upload - Upload and process ZIP archives with smart filtering
- Archive Processing - 🆕 Comprehensive guide to TAR/ZIP processing and website creation
- Webpage Upload - Create websites from TAR/ZIP files
- NFT Collection Upload - Upload entire NFT collections with automatic metadata processing
- Architecture - Project architecture and third-party integrations
- Postage Stamps - Understanding and managing storage stamps
- ENS Integration - Link your ENS domains to Swarm content
- ENS Technical Reference - Detailed ENS implementation overview
- File Formats & Limits - Supported formats and size limitations
- Troubleshooting - Common issues and solutions
- Connect your wallet from any EVM-compatible chain (Ethereum, Polygon, Arbitrum, etc.)
- Select tokens - Use ETH, USDC, MATIC, or other major tokens you already have
- Choose storage options - The app automatically bridges your tokens to Gnosis Chain for xBZZ
- Purchase or select a postage stamp for storage
- Choose your upload type:
- Single file for individual files
- Multiple files for batch uploads
- ZIP with special processing options
- Configure options based on your needs
- Upload and get your Swarm references
| Feature | File Types | Special Processing | Use Case |
|---|---|---|---|
| Single File | Any | Optional archive extraction | Individual files |
| Multiple Files | Any | Sequential upload | Batch operations |
| Folder Upload | Directories | Auto-index + TAR + website mode | 🆕 Directory sharing/websites |
| ZIP Upload | .zip | Extract + filter + index + TAR | 🆕 Clean archive distribution |
| TAR Upload | .tar | Extract + enhance + index + re-TAR | 🆕 Archive enhancement |
| Webpage Upload | .tar, .zip | Web server configuration | Static websites |
| NFT Collection | .zip | Metadata URL rewriting | NFT projects |
| ENS Integration | Any | Content hash linking | Domain-based access |
- Folder uploads → Instant browsable websites
- Auto-generated index.html with professional branding
- Smart file filtering removes system metadata
- Long filename handling for TAR compatibility
- ZIP extraction with automatic website mode
- TAR enhancement adds missing index files
- System file cleanup (PAX headers, __MACOSX, .DS_Store)
- Cross-platform compatibility Windows/Mac/Linux
- Auto-detection of best upload method
- Filename truncation for TAR format compliance
- Metadata filtering for clean, professional results
- Responsive index pages work on all devices
- Wallet: MetaMask or compatible Web3 wallet
- Network: Any EVM-compatible chain (automatically bridges to Gnosis Chain via LI.FI)
- Browser: Modern browser with JavaScript enabled
- Files: See individual guides for format requirements
For detailed information on each feature, click on the links above or browse the individual guide files.