Merge pull request #25 from ethersphere/docs

feat: Docs

Author: 0xCardiE

docs/README.md

@@ -0,0 +1,62 @@
+# Swarm Upload Documentation
+
+Welcome to the comprehensive guide for uploading files to the Swarm network using our application. This documentation covers all available upload features and options.
+
+## 📚 Available Guides
+
+### Core Upload Features
+
+- **[Single File Upload](./single-file-upload.md)** - Basic file upload functionality
+- **[Multiple File Upload](./multiple-file-upload.md)** - Upload multiple files to the same stamp
+- **[ZIP File Upload](./zip-file-upload.md)** - Upload and process ZIP archives
+
+### Advanced Features
+
+- **[Webpage Upload](./webpage-upload.md)** - Create websites from TAR/ZIP files
+- **[NFT Collection Upload](./nft-collection-upload.md)** - Upload entire NFT collections with automatic metadata processing
+- **[Archive Processing](./archive-processing.md)** - How ZIP, TAR, and GZ files are handled
+
+### Technical Guides
+
+- **[Architecture](./architecture.md)** - Project architecture and third-party integrations
+- **[Postage Stamps](./postage-stamps.md)** - Understanding and managing storage stamps
+- **[File Formats & Limits](./file-formats-limits.md)** - Supported formats and size limitations
+- **[Troubleshooting](./troubleshooting.md)** - Common issues and solutions
+
+## 🚀 Quick Start
+
+1. **Connect your wallet** to get started
+2. **Purchase or select a postage stamp** for storage
+3. **Choose your upload type**:
+   - Single file for individual files
+   - Multiple files for batch uploads
+   - ZIP with special processing options
+4. **Configure options** based on your needs
+5. **Upload and get your Swarm references**
+
+## 🔗 Useful Links
+
+- [Swarm Network Documentation](https://docs.ethswarm.org/)
+- [Bee API Documentation](https://docs.ethswarm.org/docs/api-reference/)
+- [bzz.link Gateway](https://bzz.link/)
+
+## 📋 Feature Overview
+
+| Feature        | File Types | Special Processing          | Use Case             |
+| -------------- | ---------- | --------------------------- | -------------------- |
+| Single File    | Any        | Optional archive extraction | Individual files     |
+| Multiple Files | Any        | Sequential upload           | Batch operations     |
+| ZIP Upload     | .zip       | Extract → TAR conversion    | Archive distribution |
+| Webpage Upload | .tar, .zip | Web server configuration    | Static websites      |
+| NFT Collection | .zip       | Metadata URL rewriting      | NFT projects         |
+
+## 🛠️ Technical Requirements
+
+- **Wallet**: MetaMask or compatible Web3 wallet
+- **Network**: Gnosis Chain (for postage stamps)
+- **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._