TGCloud offers a simple, secure, and free way to store and manage files. Built with modern web technologies, it uses Telegram's infrastructure to provide unlimited cloud storage without restrictions.

• Completely Free: Unlike traditional cloud storage services with tiered payment plans, TGCloud is 100% free with no hidden costs or premium tiers.
• No Storage Limits: Leverage Telegram's unlimited storage capabilities without restrictions on file size or total storage used.
• Privacy-Focused: Your files are stored in private Telegram channels accessible only to you.
• Simple & Fast: Modern interface designed for easy file management with quick uploads and downloads.
• Open Source: Fully transparent codebase you can inspect, modify, and contribute to.

• Unlimited Storage: Store as many files as you need—TGCloud utilizes Telegram's channel storage without restrictions.
• Secure and Private: Each user has a unique, private Telegram channel, ensuring their files are only accessible to them.
• File Organization: Create folders and organize your files with a familiar interface.
• File Sharing: Generate temporary links to share files with others.
• File Preview: View images, videos, and documents directly in the browser.

1. Create an Account: Sign up on TGCloud and connect your Telegram account when prompted.
2. Private Storage Channel: Once connected, TGCloud automatically creates a private Telegram channel for you.
3. Store Files Securely: All uploaded files are sent to this private channel, where they remain accessible only to you.
4. Access Anywhere: Log in to your TGCloud account from any device to access your files.

• Node.js 18.x or higher
• PostgreSQL database
• Telegram Bot token

1. Clone the repository:

git clone https://github.com/kumneger0/TGCloud.git
cd TGCloud

2. Install dependencies:

pnpm install

3. Set up environment variables:

Create your environment files for development and production using the provided .env.example as a template:

cp .env.example .env.development
cp .env.example .env.production

Edit both .env.development and .env.production and replace all placeholder values with your own credentials

4. Set up the database:

pnpm db:migrate

5. Run the development server:

pnpm dev

Open http://localhost:3000 in your browser to see the application.

• Next.js
• Tailwind CSS
• Shadcn UI
• Drizzle ORM
• PostgreSQL
• Better Auth
• Telegram API
• Dexie (for client-side caching)

Contributions are welcome! Please feel free to submit a Pull Request.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add some amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

We are committed to providing a welcoming and inclusive experience for everyone. We expect all participants in our community to abide by our Code of Conduct. Please read it to understand what behaviors will and will not be tolerated.

This project is licensed under the GNU General Public License v3.0 - see the LICENSE file for details.

For questions or support, please reach out to:

• Email: tgcloud@kumneger.dev
• Project Lead: Kumneger Wondimu