SnowShare

SnowShare is a modern, secure file and link sharing platform built with Next.js, Prisma, and NextAuth.
It provides a clean, user-friendly interface for sharing URLs, text snippets, and files with customizable options for expiration, privacy, and access.

Features ✨

LinkShare 🔗

• Share any URL with a customizable shortened link
• Set expiration times (1 day to solar explosion) ⏳
• Option for no expiration (authenticated users)
• Custom slugs for personalized links
• Password protection for enhanced security 🔒
• Instant QR code generation for shared links 📱

PasteShare 📋

• Share code snippets and text with syntax highlighting 🎨
• Support for multiple programming languages
• Expiration options and password protection 🔒
• Ideal for sharing code samples, configuration files, or any text content

FileShare 📁

• Secure file uploads with size limits
• Automatic file type detection
• Download tracking 📥
• Same expiration and protection features

User Management 👥

• User registration and authentication via NextAuth 🔑

• Frontend: Next.js 15.5, React 19.1, TailwindCSS 4

• Authentication: NextAuth.js with bcrypt password hashing

• Special Features: QR code generation, custom URL slugs

Getting Started 🚀

• Node.js 18+ and npm/yarn
• PostgreSQL database

Prerequisites ✅

• Node.js 18+ and npm/yarn

• PostgreSQL database

• Node.js 18+ and npm/yarn

• PostgreSQL database

Installation 🛠️

1. Clone the repository

   git clone https://github.com/TuroYT/snowshare
   cd snowshare
   

2. Install dependencies

   npm install
   

3. Set up environment variables Create a .env file in the root directory with the following variables:

   # Database
   DATABASE_URL="postgresql://username:password@localhost:5432/snowshare"
   
   # NextAuth
   NEXTAUTH_URL="http://localhost:3000"
   NEXTAUTH_SECRET="your-secret-key"
   
   # Auth (allow or disallow user signups)
   ALLOW_SIGNUP=true
   

Docker

You can run the app and a PostgreSQL database locally using Docker Compose.

1. Copy .env.example to .env and adjust values as needed.
2. Build and start the stack:

docker compose up -d --build

The app will be available at http://localhost:3000 and PostgreSQL at port 5432. Data persists in the db-data volume and uploaded files in the local uploads/ folder.

On startup, the app runs prisma migrate deploy to ensure the database schema is up to date.

4. Initialize the database

   npx prisma migrate dev
   

5. Start the development server

   npm run dev
   

6. Open http://localhost:3000 with your browser to see the result.

Project Structure 🗂️

/
├── prisma/                # Prisma schema and migrations
├── public/                # Static assets
└── src/
    ├── app/               # Next.js App Router structure
    │   ├── api/           # API routes
    │   ├── auth/          # Authentication pages
    │   ├── protected/     # Protected slugs and shares
    │   └── s/             # Short link redirects
    ├── components/        # React components
    ├── hooks/             # Custom React hooks
    └── lib/               # Utility functions and shared code

🙏 Acknowledgments

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

License ⚖️

This project is licensed under the MIT License - see the LICENSE file for details.

Star History

Acknowledgments / Credits 🙌

• Next.js - The React Framework
• Prisma - Next-generation ORM
• NextAuth.js - Authentication for Next.js
• TailwindCSS - Utility-first CSS framework