Key Concepts
Understanding these fundamental concepts will help you get the most out of Bantam.
Projects
Section titled “Projects”A project is a container for your uploaded content. Every file you upload belongs to a project. You can think of a project as a link, where if you upload an image, ‘catpicture.jpg’, it would be available at yourproject.bantam.site/catpicture.jpg, yourproject.yourdomain.com/catpicture.jpg, or even yourdomain.com/catpicture.jpg based on the domain you have configured.
Project Types
Section titled “Project Types”Bantam automatically detects and creates the appropriate project type based on what you upload:
Single File Projects
Section titled “Single File Projects”- What: One individual file like PDFs, images, or documents
- When to use: Sharing a presentation, document, or media file
- How Bantam Handles It: Your file will be visible directly from
yourproject.bantam.site - Features: Direct file access, built-in viewers
Collection Projects
Section titled “Collection Projects”- What: A collection of different files, without an index.html at the root.
- When to use: Sharing a set of images, documents, or mixed content
- How Bantam Handles It: A directory of your files will be visible at
yourproject.bantam.site - Features: File browser, organized structure, direct file access, built-in viewers
Site Projects
Section titled “Site Projects”- What: Any project that includes an index.html at the root.
- When to use: Hosting static websites, demos, or web applications
- How Bantam Handles It: Your website will be visible at
yourproject.bantam.site - Features: Index.html routing, asset serving, custom domains, visitor analytics
URLs and Slugs
Section titled “URLs and Slugs”Every project gets a unique URL for sharing.
Default URLs
Section titled “Default URLs”- Format:
[random-slug].bantam.site - Example:
quick-speedy-fox.bantam.site - Generated automatically
- Guaranteed unique
Custom Slugs
Section titled “Custom Slugs”- Choose your own URL ending
- Example:
whatever-you-want.bantam.site - Available for all users
- Must be unique across all projects
Custom Domains
Section titled “Custom Domains”- Use your own domain
- Example:
files.yourcompany.comoryourcompany.com - Requires Starter or Pro subscription
- Full SSL support included
Learn more about custom domains.
Expiration and Persistence
Section titled “Expiration and Persistence”Projects can be temporary or permanent, depending on your needs and subscription.
Temporary Projects
Section titled “Temporary Projects”Default expiration times by plan:
- Anonymous: 1 day
- Free Account: 3 days (max)
- Starter: 1-14 days (max)
- Pro: 1-30 days (max)
Permanent Projects
Section titled “Permanent Projects”Make projects permanent to keep them online indefinitely:
- Available for Starter and Pro plans
- No expiration date
- Can be archived or deleted manually
File Processing
Section titled “File Processing”Bantam intelligently processes uploads to provide the best experience.
Automatic Processing
Section titled “Automatic Processing”- ZIP Extraction: Website ZIPs are automatically extracted
- Index Detection: Finds and serves index.html for sites
- MIME Detection: Identifies file types for proper serving
- Optimization: Compresses assets for faster loading
- Global Cache & CDN: Sites cached and served globally
File Viewers
Section titled “File Viewers”Built-in viewers for common file types:
- PDFs: In-browser PDF viewer
- Images: Gallery with zoom and navigation
- Videos: HTML5 video player
- Code: Syntax-highlighted viewer
- Documents: Preview for Word, Excel files
Access Control
Section titled “Access Control”Control who can view your content and how.
Public Access
Section titled “Public Access”- Default for all projects
- Anyone with the link can view
- No authentication required
- Perfect for open sharing
Password Protection
Section titled “Password Protection”- Set a password for sensitive content
- Viewers must enter password to access
- Available for Starter and Pro plans
- Password can be changed anytime
Storage and Limits
Section titled “Storage and Limits”Understanding storage helps you manage your content effectively.
Storage Limits by Plan
Section titled “Storage Limits by Plan”| Plan | Storage | Projects |
|---|---|---|
| Anonymous | N/A | 2/day |
| Free | 10MB | 2 active |
| Starter | 1GB | Unlimited |
| Pro | 10GB | Unlimited |
Storage Calculation
Section titled “Storage Calculation”- Based on original file sizes
- Includes all active and archived projects
- Expired & Deleted projects free up space immediately
Analytics and Insights
Section titled “Analytics and Insights”Track how your content performs.
Analytics (Pro)
Section titled “Analytics (Pro)”- Total requests/views
- Unique visitors
- Device types
- Referral sources
- Path-based tracking
- Time-based trends
Learn more in our analytics guide.
API and Integrations
Section titled “API and Integrations”Extend Bantam with programmatic access.
Personal Access Tokens
Section titled “Personal Access Tokens”- Provide secure API authentication for use in Integrations
- Revocable anytime
Available Integrations
Section titled “Available Integrations”- bantam.host Chrome Extension
- More coming soon!
Next Steps
Section titled “Next Steps”Now that you understand the concepts:
- Upload your first file - Put knowledge into practice
- Explore project management - Organize your content
- Set up custom domains - Brand your content