shortyShorty

Self-hosted short links for Express + MongoDB: UTM builder, click analytics, React admin UI

📦

Embedded, not external

`npm install @jeffjassky/shorty`, mount the routers, done. Your users stay signed in to your app — no redirect to a third-party service, no SSO handshake, no data leaving your database.

🪪

Your auth, not ours

One `resolveUser(req)` function is the entire integration contract. Sessions, JWTs, API keys — shorty never authenticates anyone, it just asks who is calling.

🎛️

Prebuilt React UI

One bundle, served from your own domain at any mount path. No bundler in your app, no framework agreement — the host can be Vue, Svelte, or server-rendered.

🧹

Honest about deletion

`purgeUser()` removes everything shorty stored about them and repairs every derived value it touches. One call in your account-deletion path.

import mongoose from 'mongoose';
import express from 'express';
import { createShorty } from '@jeffjassky/shorty';

await mongoose.connect(process.env.MONGO_URL);

const pkg = createShorty({
  connection: mongoose,
  resolveUser: (req) => req.session.user && {
    id: req.session.user._id,
    email: req.session.user.email,
    displayName: req.session.user.name,
    isAdmin: req.session.user.role === 'admin',
  },
});

const app = express();
app.use(express.json());

// Public
app.use('/api/shorty', requireAuth, pkg.routes);
app.use('/shorty',    requireAuth, pkg.ui({ mountPath: '/shorty' }));

// Admin — separate guard, separate route
app.use('/api/shorty/admin', requireAuth, requireAdmin, pkg.adminRoutes);
app.use('/admin/shorty',    requireAuth, requireAdmin,
        pkg.adminUi({ mountPath: '/admin/shorty' }));