{"id":26578725,"url":"https://github.com/bansal/folder","last_synced_at":"2025-04-07T21:16:13.645Z","repository":{"id":282355388,"uuid":"945405562","full_name":"bansal/folder","owner":"bansal","description":"Folder – An open-source Google Drive alternative, powered by Cloudflare. 🚀","archived":false,"fork":false,"pushed_at":"2025-03-24T05:52:10.000Z","size":296,"stargazers_count":479,"open_issues_count":5,"forks_count":35,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-03-31T20:11:48.095Z","etag":null,"topics":["dam","drive","filesystem","hosting","nuxt","serverless"],"latest_commit_sha":null,"homepage":"https://folder.run/","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/bansal.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-03-09T10:49:57.000Z","updated_at":"2025-03-31T14:06:57.000Z","dependencies_parsed_at":null,"dependency_job_id":"a2a48a60-9ed1-46ca-8400-5b4a5035b318","html_url":"https://github.com/bansal/folder","commit_stats":null,"previous_names":["bansal/folder"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bansal%2Ffolder","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bansal%2Ffolder/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bansal%2Ffolder/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bansal%2Ffolder/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bansal","download_url":"https://codeload.github.com/bansal/folder/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247730069,"owners_count":20986404,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["dam","drive","filesystem","hosting","nuxt","serverless"],"created_at":"2025-03-23T05:01:51.959Z","updated_at":"2025-04-07T21:16:13.620Z","avatar_url":"https://github.com/bansal.png","language":"TypeScript","funding_links":[],"categories":["TypeScript"],"sub_categories":[],"readme":"# Folder\n\nAn open-source, serverless **Digital Asset Management (DAM)** software that helps you **store, organize, and share** files and folders. With **Folder**, you can securely share files, manage permissions, and even publish folders as a static website.\n\n![Folder Preview](https://folder.run/preview/0.0.png)\n![Folder Preview](https://folder.run/preview/6.0.png)\n![Folder Preview](https://folder.run/preview/1.0.png)\n\n## Why Folder?\n\n- **Alternative to Google Drive**: Store files, manage assets, and serve them via CDN.\n- **Built for AI \u0026 Modern Workflows**: Direct file access for AI training or querying.\n- **Developer-Friendly**: Deploy on Cloudflare with **serverless architecture**.\n\n## Tech Stack\n\n- **Frontend**: Nuxt, TailwindCSS, Nuxt UI\n- **Backend**: Nitro\n- **Database**: Cloudflare D1\n- **Storage**: Cloudflare R2\n- **Authentication**: OAuth (Google, GitHub)\n- **Server**: Cloudflare Workers\n- **Deployment**: Cloudflare Wrangler\n\n## Features\n\n- Intuitive file and folder management\n- Files and Folder uploads\n- Secure file sharing with customizable permissions\n- Public/Private visibility settings\n- Public folder as website\n- File previews for common formats\n- Search functionality\n- Responsive design for mobile and desktop\n- Dark mode\n- Authentication with Google and Github\n- Custom domain support\n- Serverless architecture\n\n## Prerequisites\n\n1. **Cloudflare Account** (for R2, D1 and Hosting)\n2. **GitHub/Google Cloud Account** (for OAuth authentication)\n3. **Domain name** (optional, for custom domains)\n\n## Deployment\n\n1. **Create Cloudflare resources**\n   - Set up **D1 Database**\n   - Create an **R2 Bucket**\n2. **Set up OAuth**\n   - Create an OAuth App in **GitHub Developer Settings** (or Google Cloud Console)\n   - Obtain **Client ID \u0026 Secret**\n3. Clone the repository\n\n   ```sh\n   git clone https://github.com/bansal/folder.git\n   cd folder\n   ```\n\n4. Install dependencies: `npm install`\n5. Configure Cloudflare credentials\n   - Rename `wrapper.example.toml` → `wrapper.toml`\n   - Update `wrapper.toml` the configuration with your **Cloudflare API key, R2 bucket name, and D1 DB name**\n6. Deploy to Cloudflare Workers: `npm run deploy`\n\n## Local Development\n\n1. Configure your environment variables in a `.env` file\n2. Install dependencies: `npm install`\n3. Start the development server: `npm run dev`\n4. Visit [http://localhost:3000](http://localhost:3000) in your browser\n\n## Contributing\n\nContributions are welcome! Please feel free to submit a Pull Request.\n\n1. Fork the repository\n2. Create your feature branch: `git checkout -b feature/amazing-feature`\n3. Commit your changes: `git commit -m 'Add some amazing feature'`\n4. Push to the branch: `git push origin feature/amazing-feature`\n5. Open a Pull Request\n\n## Disclaimer\n\nThis project is still in development. **Use at your own risk.** See [DISCLAIMER](DISCLAIMER.md) for details.\n\n## License\n\nRead [LICENSE](LICENSE)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbansal%2Ffolder","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbansal%2Ffolder","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbansal%2Ffolder/lists"}