upload.earth 🌍

Professional image hosting service built with Next.js 14

A modern image hosting platform with drag & drop uploads, API access, password protection, and user management. Built with Next.js 14, TypeScript, MongoDB, and AWS S3.

Screenshots

Features

Drag & drop image upload with progress tracking
Multiple image upload (up to 10 images)
Custom file naming and password protection
Retention policies (1h, 24h, 7d, 30d, or custom)
User authentication with JWT
RESTful API for programmatic uploads
Dark mode and multi-language support (EN, FR, TR)
QR code generation and bulk download
Admin panel for user and image management
Rate limiting and storage limits
SEO optimized with structured data

Prerequisites

Node.js 18.x or later
MongoDB (local or Atlas)
AWS S3 bucket with IAM credentials

Installation

Clone the repository:

git clone https://github.com/yourusername/image-cloud.git
cd image-cloud

Install dependencies:

npm install

Create .env.local:

MONGODB_URI=mongodb://localhost:27017/image-cloudAWS_ACCESS_KEY_ID=your_access_key_idAWS_SECRET_ACCESS_KEY=your_secret_access_keyAWS_S3_BUCKET_NAME=your_bucket_nameAWS_REGION=us-east-1NEXT_PUBLIC_BASE_URL=http://localhost:3000BASE_URL=http://localhost:3000JWT_SECRET=jwt_keyJWT_EXPIRES_IN=7d

Run development server:

npm run dev

API Usage

Upload Image

curl -X POST http://localhost:3000/api/upload \
-H "Authorization: Bearer YOUR_API_KEY" \
-F "file=@/path/to/image.jpg" \
-F "customFileName=my-image" \
-F "retentionTime=86400" \
-F "password=secure_password"

Get Image

curl http://localhost:3000/api/image/my-image-abc123.jpg

Get User Images

curl http://localhost:3000/api/user/images \
-H "Authorization: Bearer YOUR_JWT_TOKEN"

Available Scripts

npm run dev # Start development server
npm run build # Build for production
npm start # Start production server
npm run lint # Run linter

Project Structure

app/ # Next.js App Router
├── api/ # API routes
├── image/ # Image viewing page
├── my-images/ # User dashboard
└── ...
components/ # React components
lib/ # Utilities (JWT, MongoDB, S3, etc.)
models/ # Mongoose models

Deployment

Vercel (Recommended)

Push to GitHub
Import repository in Vercel
Add environment variables
Deploy

The application can also be deployed to Netlify, Railway, AWS Amplify, or any platform supporting Next.js.

Environment Variables

Variable	Description	Required
`MONGODB_URI`	MongoDB connection string	Yes
`AWS_ACCESS_KEY_ID`	AWS S3 access key	Yes
`AWS_SECRET_ACCESS_KEY`	AWS S3 secret key	Yes
`AWS_S3_BUCKET_NAME`	S3 bucket name	Yes
`AWS_REGION`	AWS region	Yes
`NEXT_PUBLIC_BASE_URL`	Public-facing URL	Yes
`BASE_URL`	Server-side URL	Yes
`JWT_SECRET`	JWT signing secret	Yes
`JWT_EXPIRES_IN`	JWT expiration (default: 7d)	No
`MAX_BUCKET_SIZE_GB`	Global bucket size limit	No
`NEXT_PUBLIC_GOOGLE_ANALYTICS_ID`	Google Analytics ID	No

Contributing

Fork the repository
Create a feature branch (git checkout -b feature/amazing-feature)
Commit your changes (git commit -m 'feat: Add amazing feature')
Push to the branch (git push origin feature/amazing-feature)
Open a Pull Request

License

See LICENSE for more details.

Support

For support, contact: p@evoise.dev

Made with ❤️ by evoise

upload.earth 🌍

Professional image hosting service built with Next.js 14

A modern image hosting platform with drag & drop uploads, API access, password protection, and user management. Built with Next.js 14, TypeScript, MongoDB, and AWS S3.

Screenshots

Features

Drag & drop image upload with progress tracking
Multiple image upload (up to 10 images)
Custom file naming and password protection
Retention policies (1h, 24h, 7d, 30d, or custom)
User authentication with JWT
RESTful API for programmatic uploads
Dark mode and multi-language support (EN, FR, TR)
QR code generation and bulk download
Admin panel for user and image management
Rate limiting and storage limits
SEO optimized with structured data

Prerequisites

Node.js 18.x or later
MongoDB (local or Atlas)
AWS S3 bucket with IAM credentials

Installation

Clone the repository:

git clone https://github.com/yourusername/image-cloud.git
cd image-cloud

Install dependencies:

npm install

Create .env.local:

MONGODB_URI=mongodb://localhost:27017/image-cloudAWS_ACCESS_KEY_ID=your_access_key_idAWS_SECRET_ACCESS_KEY=your_secret_access_keyAWS_S3_BUCKET_NAME=your_bucket_nameAWS_REGION=us-east-1NEXT_PUBLIC_BASE_URL=http://localhost:3000BASE_URL=http://localhost:3000JWT_SECRET=jwt_keyJWT_EXPIRES_IN=7d

Run development server:

npm run dev

API Usage

Upload Image

curl -X POST http://localhost:3000/api/upload \
-H "Authorization: Bearer YOUR_API_KEY" \
-F "file=@/path/to/image.jpg" \
-F "customFileName=my-image" \
-F "retentionTime=86400" \
-F "password=secure_password"

Get Image

curl http://localhost:3000/api/image/my-image-abc123.jpg

Get User Images

curl http://localhost:3000/api/user/images \
-H "Authorization: Bearer YOUR_JWT_TOKEN"

Available Scripts

npm run dev # Start development server
npm run build # Build for production
npm start # Start production server
npm run lint # Run linter

Project Structure

app/ # Next.js App Router
├── api/ # API routes
├── image/ # Image viewing page
├── my-images/ # User dashboard
└── ...
components/ # React components
lib/ # Utilities (JWT, MongoDB, S3, etc.)
models/ # Mongoose models

Deployment

Vercel (Recommended)

Push to GitHub
Import repository in Vercel
Add environment variables
Deploy

The application can also be deployed to Netlify, Railway, AWS Amplify, or any platform supporting Next.js.

Environment Variables

Variable	Description	Required
`MONGODB_URI`	MongoDB connection string	Yes
`AWS_ACCESS_KEY_ID`	AWS S3 access key	Yes
`AWS_SECRET_ACCESS_KEY`	AWS S3 secret key	Yes
`AWS_S3_BUCKET_NAME`	S3 bucket name	Yes
`AWS_REGION`	AWS region	Yes
`NEXT_PUBLIC_BASE_URL`	Public-facing URL	Yes
`BASE_URL`	Server-side URL	Yes
`JWT_SECRET`	JWT signing secret	Yes
`JWT_EXPIRES_IN`	JWT expiration (default: 7d)	No
`MAX_BUCKET_SIZE_GB`	Global bucket size limit	No
`NEXT_PUBLIC_GOOGLE_ANALYTICS_ID`	Google Analytics ID	No

Contributing

Fork the repository
Create a feature branch (git checkout -b feature/amazing-feature)
Commit your changes (git commit -m 'feat: Add amazing feature')
Push to the branch (git push origin feature/amazing-feature)
Open a Pull Request

License

See LICENSE for more details.

Support

For support, contact: p@evoise.dev

Made with ❤️ by evoise

upload.earth 🌍

Professional image hosting service built with Next.js 14

A modern image hosting platform with drag & drop uploads, API access, password protection, and user management. Built with Next.js 14, TypeScript, MongoDB, and AWS S3.

Screenshots

Features

Drag & drop image upload with progress tracking
Multiple image upload (up to 10 images)
Custom file naming and password protection
Retention policies (1h, 24h, 7d, 30d, or custom)
User authentication with JWT
RESTful API for programmatic uploads
Dark mode and multi-language support (EN, FR, TR)
QR code generation and bulk download
Admin panel for user and image management
Rate limiting and storage limits
SEO optimized with structured data

Prerequisites

Node.js 18.x or later
MongoDB (local or Atlas)
AWS S3 bucket with IAM credentials

Installation

Clone the repository:

git clone https://github.com/yourusername/image-cloud.git
cd image-cloud

Install dependencies:

npm install

Create .env.local:

MONGODB_URI=mongodb://localhost:27017/image-cloudAWS_ACCESS_KEY_ID=your_access_key_idAWS_SECRET_ACCESS_KEY=your_secret_access_keyAWS_S3_BUCKET_NAME=your_bucket_nameAWS_REGION=us-east-1NEXT_PUBLIC_BASE_URL=http://localhost:3000BASE_URL=http://localhost:3000JWT_SECRET=jwt_keyJWT_EXPIRES_IN=7d

Run development server:

npm run dev

API Usage

Upload Image

curl -X POST http://localhost:3000/api/upload \
-H "Authorization: Bearer YOUR_API_KEY" \
-F "file=@/path/to/image.jpg" \
-F "customFileName=my-image" \
-F "retentionTime=86400" \
-F "password=secure_password"

Get Image

curl http://localhost:3000/api/image/my-image-abc123.jpg

Get User Images

curl http://localhost:3000/api/user/images \
-H "Authorization: Bearer YOUR_JWT_TOKEN"

Available Scripts

npm run dev # Start development server
npm run build # Build for production
npm start # Start production server
npm run lint # Run linter

Project Structure

app/ # Next.js App Router
├── api/ # API routes
├── image/ # Image viewing page
├── my-images/ # User dashboard
└── ...
components/ # React components
lib/ # Utilities (JWT, MongoDB, S3, etc.)
models/ # Mongoose models

Deployment

Vercel (Recommended)

Push to GitHub
Import repository in Vercel
Add environment variables
Deploy

The application can also be deployed to Netlify, Railway, AWS Amplify, or any platform supporting Next.js.

Environment Variables

Variable	Description	Required
`MONGODB_URI`	MongoDB connection string	Yes
`AWS_ACCESS_KEY_ID`	AWS S3 access key	Yes
`AWS_SECRET_ACCESS_KEY`	AWS S3 secret key	Yes
`AWS_S3_BUCKET_NAME`	S3 bucket name	Yes
`AWS_REGION`	AWS region	Yes
`NEXT_PUBLIC_BASE_URL`	Public-facing URL	Yes
`BASE_URL`	Server-side URL	Yes
`JWT_SECRET`	JWT signing secret	Yes
`JWT_EXPIRES_IN`	JWT expiration (default: 7d)	No
`MAX_BUCKET_SIZE_GB`	Global bucket size limit	No
`NEXT_PUBLIC_GOOGLE_ANALYTICS_ID`	Google Analytics ID	No

Contributing

Fork the repository
Create a feature branch (git checkout -b feature/amazing-feature)
Commit your changes (git commit -m 'feat: Add amazing feature')
Push to the branch (git push origin feature/amazing-feature)
Open a Pull Request

License

See LICENSE for more details.

Support

For support, contact: p@evoise.dev

Made with ❤️ by evoise

upload.earth 🌍

Professional image hosting service built with Next.js 14

A modern image hosting platform with drag & drop uploads, API access, password protection, and user management. Built with Next.js 14, TypeScript, MongoDB, and AWS S3.

Screenshots

Features

Drag & drop image upload with progress tracking
Multiple image upload (up to 10 images)
Custom file naming and password protection
Retention policies (1h, 24h, 7d, 30d, or custom)
User authentication with JWT
RESTful API for programmatic uploads
Dark mode and multi-language support (EN, FR, TR)
QR code generation and bulk download
Admin panel for user and image management
Rate limiting and storage limits
SEO optimized with structured data

Prerequisites

Node.js 18.x or later
MongoDB (local or Atlas)
AWS S3 bucket with IAM credentials

Installation

Clone the repository:

git clone https://github.com/yourusername/image-cloud.git
cd image-cloud

Install dependencies:

npm install

Create .env.local:

MONGODB_URI=mongodb://localhost:27017/image-cloudAWS_ACCESS_KEY_ID=your_access_key_idAWS_SECRET_ACCESS_KEY=your_secret_access_keyAWS_S3_BUCKET_NAME=your_bucket_nameAWS_REGION=us-east-1NEXT_PUBLIC_BASE_URL=http://localhost:3000BASE_URL=http://localhost:3000JWT_SECRET=jwt_keyJWT_EXPIRES_IN=7d

Run development server:

npm run dev

API Usage

Upload Image

curl -X POST http://localhost:3000/api/upload \
-H "Authorization: Bearer YOUR_API_KEY" \
-F "file=@/path/to/image.jpg" \
-F "customFileName=my-image" \
-F "retentionTime=86400" \
-F "password=secure_password"

Get Image

curl http://localhost:3000/api/image/my-image-abc123.jpg

Get User Images

curl http://localhost:3000/api/user/images \
-H "Authorization: Bearer YOUR_JWT_TOKEN"

Available Scripts

npm run dev # Start development server
npm run build # Build for production
npm start # Start production server
npm run lint # Run linter

Project Structure

app/ # Next.js App Router
├── api/ # API routes
├── image/ # Image viewing page
├── my-images/ # User dashboard
└── ...
components/ # React components
lib/ # Utilities (JWT, MongoDB, S3, etc.)
models/ # Mongoose models

Deployment

Vercel (Recommended)

Push to GitHub
Import repository in Vercel
Add environment variables
Deploy

The application can also be deployed to Netlify, Railway, AWS Amplify, or any platform supporting Next.js.

Environment Variables

Variable	Description	Required
`MONGODB_URI`	MongoDB connection string	Yes
`AWS_ACCESS_KEY_ID`	AWS S3 access key	Yes
`AWS_SECRET_ACCESS_KEY`	AWS S3 secret key	Yes
`AWS_S3_BUCKET_NAME`	S3 bucket name	Yes
`AWS_REGION`	AWS region	Yes
`NEXT_PUBLIC_BASE_URL`	Public-facing URL	Yes
`BASE_URL`	Server-side URL	Yes
`JWT_SECRET`	JWT signing secret	Yes
`JWT_EXPIRES_IN`	JWT expiration (default: 7d)	No
`MAX_BUCKET_SIZE_GB`	Global bucket size limit	No
`NEXT_PUBLIC_GOOGLE_ANALYTICS_ID`	Google Analytics ID	No

Contributing

Fork the repository
Create a feature branch (git checkout -b feature/amazing-feature)
Commit your changes (git commit -m 'feat: Add amazing feature')
Push to the branch (git push origin feature/amazing-feature)
Open a Pull Request

License

See LICENSE for more details.

Support

For support, contact: p@evoise.dev

Made with ❤️ by evoise

upload.earth 🌍

Professional image hosting service built with Next.js 14

A modern image hosting platform with drag & drop uploads, API access, password protection, and user management. Built with Next.js 14, TypeScript, MongoDB, and AWS S3.

Screenshots

Features

Drag & drop image upload with progress tracking
Multiple image upload (up to 10 images)
Custom file naming and password protection
Retention policies (1h, 24h, 7d, 30d, or custom)
User authentication with JWT
RESTful API for programmatic uploads
Dark mode and multi-language support (EN, FR, TR)
QR code generation and bulk download
Admin panel for user and image management
Rate limiting and storage limits
SEO optimized with structured data

Prerequisites

Node.js 18.x or later
MongoDB (local or Atlas)
AWS S3 bucket with IAM credentials

Installation

Clone the repository:

git clone https://github.com/yourusername/image-cloud.git
cd image-cloud

Install dependencies:

npm install

Create .env.local:

MONGODB_URI=mongodb://localhost:27017/image-cloudAWS_ACCESS_KEY_ID=your_access_key_idAWS_SECRET_ACCESS_KEY=your_secret_access_keyAWS_S3_BUCKET_NAME=your_bucket_nameAWS_REGION=us-east-1NEXT_PUBLIC_BASE_URL=http://localhost:3000BASE_URL=http://localhost:3000JWT_SECRET=jwt_keyJWT_EXPIRES_IN=7d

Run development server:

npm run dev

API Usage

Upload Image

curl -X POST http://localhost:3000/api/upload \
-H "Authorization: Bearer YOUR_API_KEY" \
-F "file=@/path/to/image.jpg" \
-F "customFileName=my-image" \
-F "retentionTime=86400" \
-F "password=secure_password"

Get Image

curl http://localhost:3000/api/image/my-image-abc123.jpg

Get User Images

curl http://localhost:3000/api/user/images \
-H "Authorization: Bearer YOUR_JWT_TOKEN"

Available Scripts

npm run dev # Start development server
npm run build # Build for production
npm start # Start production server
npm run lint # Run linter

Project Structure

app/ # Next.js App Router
├── api/ # API routes
├── image/ # Image viewing page
├── my-images/ # User dashboard
└── ...
components/ # React components
lib/ # Utilities (JWT, MongoDB, S3, etc.)
models/ # Mongoose models

Deployment

Vercel (Recommended)

Push to GitHub
Import repository in Vercel
Add environment variables
Deploy

The application can also be deployed to Netlify, Railway, AWS Amplify, or any platform supporting Next.js.

Environment Variables

Variable	Description	Required
`MONGODB_URI`	MongoDB connection string	Yes
`AWS_ACCESS_KEY_ID`	AWS S3 access key	Yes
`AWS_SECRET_ACCESS_KEY`	AWS S3 secret key	Yes
`AWS_S3_BUCKET_NAME`	S3 bucket name	Yes
`AWS_REGION`	AWS region	Yes
`NEXT_PUBLIC_BASE_URL`	Public-facing URL	Yes
`BASE_URL`	Server-side URL	Yes
`JWT_SECRET`	JWT signing secret	Yes
`JWT_EXPIRES_IN`	JWT expiration (default: 7d)	No
`MAX_BUCKET_SIZE_GB`	Global bucket size limit	No
`NEXT_PUBLIC_GOOGLE_ANALYTICS_ID`	Google Analytics ID	No

Contributing

Fork the repository
Create a feature branch (git checkout -b feature/amazing-feature)
Commit your changes (git commit -m 'feat: Add amazing feature')
Push to the branch (git push origin feature/amazing-feature)
Open a Pull Request

License

See LICENSE for more details.

Support

For support, contact: p@evoise.dev

Made with ❤️ by evoise

upload.earth 🌍

Professional image hosting service built with Next.js 14

A modern image hosting platform with drag & drop uploads, API access, password protection, and user management. Built with Next.js 14, TypeScript, MongoDB, and AWS S3.

Screenshots

Features

Drag & drop image upload with progress tracking
Multiple image upload (up to 10 images)
Custom file naming and password protection
Retention policies (1h, 24h, 7d, 30d, or custom)
User authentication with JWT
RESTful API for programmatic uploads
Dark mode and multi-language support (EN, FR, TR)
QR code generation and bulk download
Admin panel for user and image management
Rate limiting and storage limits
SEO optimized with structured data

Prerequisites

Node.js 18.x or later
MongoDB (local or Atlas)
AWS S3 bucket with IAM credentials

Installation

Clone the repository:

git clone https://github.com/yourusername/image-cloud.git
cd image-cloud

Install dependencies:

npm install

Create .env.local:

MONGODB_URI=mongodb://localhost:27017/image-cloudAWS_ACCESS_KEY_ID=your_access_key_idAWS_SECRET_ACCESS_KEY=your_secret_access_keyAWS_S3_BUCKET_NAME=your_bucket_nameAWS_REGION=us-east-1NEXT_PUBLIC_BASE_URL=http://localhost:3000BASE_URL=http://localhost:3000JWT_SECRET=jwt_keyJWT_EXPIRES_IN=7d

Run development server:

npm run dev

API Usage

Upload Image

curl -X POST http://localhost:3000/api/upload \
-H "Authorization: Bearer YOUR_API_KEY" \
-F "file=@/path/to/image.jpg" \
-F "customFileName=my-image" \
-F "retentionTime=86400" \
-F "password=secure_password"

Get Image

curl http://localhost:3000/api/image/my-image-abc123.jpg

Get User Images

curl http://localhost:3000/api/user/images \
-H "Authorization: Bearer YOUR_JWT_TOKEN"

Available Scripts

npm run dev # Start development server
npm run build # Build for production
npm start # Start production server
npm run lint # Run linter

Project Structure

app/ # Next.js App Router
├── api/ # API routes
├── image/ # Image viewing page
├── my-images/ # User dashboard
└── ...
components/ # React components
lib/ # Utilities (JWT, MongoDB, S3, etc.)
models/ # Mongoose models

Deployment

Vercel (Recommended)

Push to GitHub
Import repository in Vercel
Add environment variables
Deploy

The application can also be deployed to Netlify, Railway, AWS Amplify, or any platform supporting Next.js.

Environment Variables

Variable	Description	Required
`MONGODB_URI`	MongoDB connection string	Yes
`AWS_ACCESS_KEY_ID`	AWS S3 access key	Yes
`AWS_SECRET_ACCESS_KEY`	AWS S3 secret key	Yes
`AWS_S3_BUCKET_NAME`	S3 bucket name	Yes
`AWS_REGION`	AWS region	Yes
`NEXT_PUBLIC_BASE_URL`	Public-facing URL	Yes
`BASE_URL`	Server-side URL	Yes
`JWT_SECRET`	JWT signing secret	Yes
`JWT_EXPIRES_IN`	JWT expiration (default: 7d)	No
`MAX_BUCKET_SIZE_GB`	Global bucket size limit	No
`NEXT_PUBLIC_GOOGLE_ANALYTICS_ID`	Google Analytics ID	No

Contributing

Fork the repository
Create a feature branch (git checkout -b feature/amazing-feature)
Commit your changes (git commit -m 'feat: Add amazing feature')
Push to the branch (git push origin feature/amazing-feature)
Open a Pull Request

License

See LICENSE for more details.

Support

For support, contact: p@evoise.dev

Made with ❤️ by evoise

upload.earth 🌍

Professional image hosting service built with Next.js 14

A modern image hosting platform with drag & drop uploads, API access, password protection, and user management. Built with Next.js 14, TypeScript, MongoDB, and AWS S3.

Screenshots

Features

Drag & drop image upload with progress tracking
Multiple image upload (up to 10 images)
Custom file naming and password protection
Retention policies (1h, 24h, 7d, 30d, or custom)
User authentication with JWT
RESTful API for programmatic uploads
Dark mode and multi-language support (EN, FR, TR)
QR code generation and bulk download
Admin panel for user and image management
Rate limiting and storage limits
SEO optimized with structured data

Prerequisites

Node.js 18.x or later
MongoDB (local or Atlas)
AWS S3 bucket with IAM credentials

Installation

Clone the repository:

git clone https://github.com/yourusername/image-cloud.git
cd image-cloud

Install dependencies:

npm install

Create .env.local:

MONGODB_URI=mongodb://localhost:27017/image-cloudAWS_ACCESS_KEY_ID=your_access_key_idAWS_SECRET_ACCESS_KEY=your_secret_access_keyAWS_S3_BUCKET_NAME=your_bucket_nameAWS_REGION=us-east-1NEXT_PUBLIC_BASE_URL=http://localhost:3000BASE_URL=http://localhost:3000JWT_SECRET=jwt_keyJWT_EXPIRES_IN=7d

Run development server:

npm run dev

API Usage

Upload Image

curl -X POST http://localhost:3000/api/upload \
-H "Authorization: Bearer YOUR_API_KEY" \
-F "file=@/path/to/image.jpg" \
-F "customFileName=my-image" \
-F "retentionTime=86400" \
-F "password=secure_password"

Get Image

curl http://localhost:3000/api/image/my-image-abc123.jpg

Get User Images

curl http://localhost:3000/api/user/images \
-H "Authorization: Bearer YOUR_JWT_TOKEN"

Available Scripts

npm run dev # Start development server
npm run build # Build for production
npm start # Start production server
npm run lint # Run linter

Project Structure

app/ # Next.js App Router
├── api/ # API routes
├── image/ # Image viewing page
├── my-images/ # User dashboard
└── ...
components/ # React components
lib/ # Utilities (JWT, MongoDB, S3, etc.)
models/ # Mongoose models

Deployment

Vercel (Recommended)

Push to GitHub
Import repository in Vercel
Add environment variables
Deploy

The application can also be deployed to Netlify, Railway, AWS Amplify, or any platform supporting Next.js.

Environment Variables

Variable	Description	Required
`MONGODB_URI`	MongoDB connection string	Yes
`AWS_ACCESS_KEY_ID`	AWS S3 access key	Yes
`AWS_SECRET_ACCESS_KEY`	AWS S3 secret key	Yes
`AWS_S3_BUCKET_NAME`	S3 bucket name	Yes
`AWS_REGION`	AWS region	Yes
`NEXT_PUBLIC_BASE_URL`	Public-facing URL	Yes
`BASE_URL`	Server-side URL	Yes
`JWT_SECRET`	JWT signing secret	Yes
`JWT_EXPIRES_IN`	JWT expiration (default: 7d)	No
`MAX_BUCKET_SIZE_GB`	Global bucket size limit	No
`NEXT_PUBLIC_GOOGLE_ANALYTICS_ID`	Google Analytics ID	No

Contributing

Fork the repository
Create a feature branch (git checkout -b feature/amazing-feature)
Commit your changes (git commit -m 'feat: Add amazing feature')
Push to the branch (git push origin feature/amazing-feature)
Open a Pull Request

License

See LICENSE for more details.

Support

For support, contact: p@evoise.dev

Made with ❤️ by evoise

upload.earth 🌍

Professional image hosting service built with Next.js 14

A modern image hosting platform with drag & drop uploads, API access, password protection, and user management. Built with Next.js 14, TypeScript, MongoDB, and AWS S3.

Screenshots

Features

Drag & drop image upload with progress tracking
Multiple image upload (up to 10 images)
Custom file naming and password protection
Retention policies (1h, 24h, 7d, 30d, or custom)
User authentication with JWT
RESTful API for programmatic uploads
Dark mode and multi-language support (EN, FR, TR)
QR code generation and bulk download
Admin panel for user and image management
Rate limiting and storage limits
SEO optimized with structured data

Prerequisites

Node.js 18.x or later
MongoDB (local or Atlas)
AWS S3 bucket with IAM credentials

Installation

Clone the repository:

git clone https://github.com/yourusername/image-cloud.git
cd image-cloud

Install dependencies:

npm install

Create .env.local:

MONGODB_URI=mongodb://localhost:27017/image-cloudAWS_ACCESS_KEY_ID=your_access_key_idAWS_SECRET_ACCESS_KEY=your_secret_access_keyAWS_S3_BUCKET_NAME=your_bucket_nameAWS_REGION=us-east-1NEXT_PUBLIC_BASE_URL=http://localhost:3000BASE_URL=http://localhost:3000JWT_SECRET=jwt_keyJWT_EXPIRES_IN=7d

Run development server:

npm run dev

API Usage

Upload Image

curl -X POST http://localhost:3000/api/upload \
-H "Authorization: Bearer YOUR_API_KEY" \
-F "file=@/path/to/image.jpg" \
-F "customFileName=my-image" \
-F "retentionTime=86400" \
-F "password=secure_password"

Get Image

curl http://localhost:3000/api/image/my-image-abc123.jpg

Get User Images

curl http://localhost:3000/api/user/images \
-H "Authorization: Bearer YOUR_JWT_TOKEN"

Available Scripts

npm run dev # Start development server
npm run build # Build for production
npm start # Start production server
npm run lint # Run linter

Project Structure

app/ # Next.js App Router
├── api/ # API routes
├── image/ # Image viewing page
├── my-images/ # User dashboard
└── ...
components/ # React components
lib/ # Utilities (JWT, MongoDB, S3, etc.)
models/ # Mongoose models

Deployment

Vercel (Recommended)

Push to GitHub
Import repository in Vercel
Add environment variables
Deploy

The application can also be deployed to Netlify, Railway, AWS Amplify, or any platform supporting Next.js.

Environment Variables

Variable	Description	Required
`MONGODB_URI`	MongoDB connection string	Yes
`AWS_ACCESS_KEY_ID`	AWS S3 access key	Yes
`AWS_SECRET_ACCESS_KEY`	AWS S3 secret key	Yes
`AWS_S3_BUCKET_NAME`	S3 bucket name	Yes
`AWS_REGION`	AWS region	Yes
`NEXT_PUBLIC_BASE_URL`	Public-facing URL	Yes
`BASE_URL`	Server-side URL	Yes
`JWT_SECRET`	JWT signing secret	Yes
`JWT_EXPIRES_IN`	JWT expiration (default: 7d)	No
`MAX_BUCKET_SIZE_GB`	Global bucket size limit	No
`NEXT_PUBLIC_GOOGLE_ANALYTICS_ID`	Google Analytics ID	No

Contributing

Fork the repository
Create a feature branch (git checkout -b feature/amazing-feature)
Commit your changes (git commit -m 'feat: Add amazing feature')
Push to the branch (git push origin feature/amazing-feature)
Open a Pull Request

License

See LICENSE for more details.

Support

For support, contact: p@evoise.dev

Made with ❤️ by evoise

Name		Name	Last commit message	Last commit date
app		app
components		components
hooks		hooks
lib		lib
models		models
types		types
.eslintrc.json		.eslintrc.json
.gitignore		.gitignore
LICENSE		LICENSE
README.md		README.md
Screenshot1.png		Screenshot1.png
Screenshot2.png		Screenshot2.png
next.config.js		next.config.js
package-lock.json		package-lock.json
package.json		package.json
postcss.config.mjs		postcss.config.mjs
tailwind.config.ts		tailwind.config.ts
tsconfig.json		tsconfig.json

Name		Name	Last commit message	Last commit date
app		app
components		components
hooks		hooks
lib		lib
models		models
types		types
.eslintrc.json		.eslintrc.json
.gitignore		.gitignore
LICENSE		LICENSE
README.md		README.md
Screenshot1.png		Screenshot1.png
Screenshot2.png		Screenshot2.png
next.config.js		next.config.js
package-lock.json		package-lock.json
package.json		package.json
postcss.config.mjs		postcss.config.mjs
tailwind.config.ts		tailwind.config.ts
tsconfig.json		tsconfig.json

Name		Name	Last commit message	Last commit date
app		app
components		components
hooks		hooks
lib		lib
models		models
types		types
.eslintrc.json		.eslintrc.json
.gitignore		.gitignore
LICENSE		LICENSE
README.md		README.md
Screenshot1.png		Screenshot1.png
Screenshot2.png		Screenshot2.png
next.config.js		next.config.js
package-lock.json		package-lock.json
package.json		package.json
postcss.config.mjs		postcss.config.mjs
tailwind.config.ts		tailwind.config.ts
tsconfig.json		tsconfig.json

Name		Name	Last commit message	Last commit date
app		app
components		components
hooks		hooks
lib		lib
models		models
types		types
.eslintrc.json		.eslintrc.json
.gitignore		.gitignore
LICENSE		LICENSE
README.md		README.md
Screenshot1.png		Screenshot1.png
Screenshot2.png		Screenshot2.png
next.config.js		next.config.js
package-lock.json		package-lock.json
package.json		package.json
postcss.config.mjs		postcss.config.mjs
tailwind.config.ts		tailwind.config.ts
tsconfig.json		tsconfig.json

Name		Name	Last commit message	Last commit date
app		app
components		components
hooks		hooks
lib		lib
models		models
types		types
.eslintrc.json		.eslintrc.json
.gitignore		.gitignore
LICENSE		LICENSE
README.md		README.md
Screenshot1.png		Screenshot1.png
Screenshot2.png		Screenshot2.png
next.config.js		next.config.js
package-lock.json		package-lock.json
package.json		package.json
postcss.config.mjs		postcss.config.mjs
tailwind.config.ts		tailwind.config.ts
tsconfig.json		tsconfig.json

Latest commit

History

Folders and files

Repository files navigation

upload.earth 🌍

Screenshots

Features

Prerequisites

Installation

API Usage

Upload Image

Get Image

Get User Images

Available Scripts

Project Structure

Deployment

Vercel (Recommended)

Environment Variables

Contributing

License

Support

About

Topics

Resources

Stars

Watchers

Forks

Contributors

Languages

Latest commit

History

Folders and files

Repository files navigation

upload.earth 🌍

Screenshots

Features

Prerequisites

Installation

API Usage

Upload Image

Get Image

Get User Images

Available Scripts

Project Structure

Deployment

Vercel (Recommended)

Environment Variables

Contributing

License

Support

About

Topics

Resources

Stars

Watchers

Forks

Contributors

Languages

Latest commit

History

Folders and files

Repository files navigation

upload.earth 🌍

Screenshots

Features

Prerequisites

Installation

API Usage

Upload Image

Get Image

Get User Images

Available Scripts

Project Structure

Deployment

Vercel (Recommended)

Environment Variables

Contributing

License

Support

About