BitWay - Nezih Talha Karakoç

BitWay is a modern, full-stack URL shortener and QR code generator application built with React, Node.js, and Supabase. It features a premium glassmorphism UI, real-time analytics, and robust link management tools.

🚀 Features

Advanced URL Shortening: Create short, memorable links with custom aliases and expiration dates.
Custom QR Codes: Generate QR codes with custom foreground/background colors and embedded logos.
Comprehensive Analytics: Track total clicks, browser types, platforms, and recent activity in a visual dashboard.
Authentication: Secure user accounts using Supabase Auth (Email/Password & Google Login).
Responsive Design: Fully optimized for mobile, tablet, and desktop devices.
Modern UI: Sleek glassmorphism design with smooth animations and gradients.

🛠️ Tech Stack

Frontend: React (Vite), CSS3 (Custom Glassmorphism), Lucide React (Icons).
Backend: Node.js, Express.js.
Database & Auth: Supabase (PostgreSQL, Row Level Security).
Deployment: Netlify (Frontend & Serverless Functions).

⚙️ Installation & Setup

Prerequisites

Node.js (v18 or higher)
npm or yarn
A Supabase project

1. Clone the Repository

git clone https://github.com/nezihtalha57/bitway.git
cd bitway

2. Install Dependencies

# Install server dependencies
cd server
npm install

# Install client dependencies
cd ../client
npm install

3. Environment Variables

Create a .env file in the server directory:

PORT=3000
SUPABASE_URL=your_supabase_url
SUPABASE_KEY=your_supabase_anon_key

Create a .env file in the client directory:

VITE_SUPABASE_URL=your_supabase_url
VITE_SUPABASE_ANON_KEY=your_supabase_anon_key
VITE_API_URL=http://localhost:3000/api

4. Run Locally

# Terminal 1: Start Server
cd server
npm run dev

# Terminal 2: Start Client
cd client
npm run dev

🌍 Deployment

GitHub Pages (Recommended for Frontend)

The project is configured for automatic deployment to GitHub Pages using GitHub Actions.

Go to your repository Settings → Pages
Under "Build and deployment", select GitHub Actions as the source
Push to the main branch to trigger automatic deployment
Your site will be available at: https://YOUR_USERNAME.github.io/bitway/