Skip to content Dark Web Informer
Support
Sign In Subscribe
Tools

OneURL: An open-source alternative to Linktree. Create a profile page to share all your important links in one place

,   and  Dark Web Informer
2 min read

GitHub: https://github.com/KartikLabhshetwar/oneurl

OneURL

One URL for all your links - An open-source alternative to Linktree. Create a beautiful profile page to share all your important links in one place.

Features

  • Google OAuth Authentication - Secure and seamless sign-in with your existing Google account
  • Custom Profile Pages - Create personalized profile pages with your unique username
  • Link Management - Add, edit, and reorganize your links effortlessly
  • Deep Analytics - Track clicks and view detailed insights about your audience engagement
  • Avatar Upload - Upload and customize your profile picture with drag-and-drop support
  • Responsive Design - Your profile looks perfect on every device
  • Fast & Modern - Built with Next.js 16 and React 19 for instant page loads

Tech Stack

  • Framework: Next.js 16 (App Router)
  • Backend: Express.js (separate service for link previews)
  • Language: TypeScript
  • Database: PostgreSQL with Prisma ORM
  • Authentication: Better Auth
  • File Upload: UploadThing + React Dropzone
  • State Management: TanStack Query (React Query)
  • Styling: Tailwind CSS
  • UI Components: Base UI React
  • Charts: Recharts

Prerequisites

Before you begin, ensure you have:

  • Node.js 20+ or Bun installed
  • PostgreSQL database (local or cloud like Neon)
  • Google OAuth credentials
  • UploadThing account (free tier available)

Getting Started

1. Clone the Repository

git clone https://github.com/KartikLabhshetwar/oneurl.git
cd oneurl

2. Install Dependencies

bun install
# or
npm install

3. Set Up Environment Variables

Create a .env file in the root directory:

# Database
DATABASE_URL="postgresql://user:password@localhost:5432/oneurl"

# Better Auth
BETTER_AUTH_SECRET="your-secret-key-here"
BETTER_AUTH_URL="http://localhost:3000"

# Google OAuth
GOOGLE_CLIENT_ID="your-google-client-id"
GOOGLE_CLIENT_SECRET="your-google-client-secret"

# UploadThing - for file uploads
UPLOADTHING_TOKEN="your-uploadthing-token"

# Backend Service
# Development: http://localhost:3001
# Production: https://api.oneurl.live
BACKEND_URL="http://localhost:3001"

Note: UploadThing is optional. If not configured, you can still use the app but avatar uploads won't work. Sign up at uploadthing.com to get your credentials.

4. Set Up Database

# Generate Prisma Client
bun prisma generate

# Run migrations
bun prisma migrate dev

5. Set Up Backend Service

The backend service handles link preview metadata fetching. Create a .env file in the backend directory:

PORT=3001
FRONTEND_URL=http://localhost:3000
NODE_ENV=development

Install backend dependencies:

cd backend
bun install
cd ..

6. Run the Development Servers

Option 1: Run both services together

bun run dev:all

Option 2: Run separately

# Terminal 1 - Frontend
bun run dev

# Terminal 2 - Backend
bun run dev:backend

Open http://localhost:3000 in your browser. The backend service runs on http://localhost:3001.

Project Structure

oneurl/
├── app/                    # Next.js app directory
│   ├── (auth)/            # Authentication routes (login, signup)
│   ├── (dashboard)/       # Dashboard routes (protected)
│   ├── (onboarding)/      # Onboarding flow
│   ├── [username]/        # Public profile pages
│   └── api/               # API routes
├── backend/               # Express backend service
│   ├── src/
│   │   ├── routes/        # API routes
│   │   ├── middleware/    # Rate limiting, validation, error handling
│   │   └── utils/         # Metadata fetching utilities
│   └── package.json       # Backend dependencies
├── components/            # React components
│   ├── landing/           # Landing page components
│   └── ui/                # UI component library
├── hooks/                 # Custom React hooks
├── lib/                   # Utility functions and services
│   ├── generated/         # Generated Prisma client
│   ├── hooks/             # Custom hooks
│   ├── services/          # Business logic services
│   └── validations/       # Zod schemas
├── prisma/                # Prisma schema and migrations
└── public/                # Static assets

Related

Latest