FireShort

A modern URL shortener built with React, Material UI and Firebase.

Authentication of this project has been taken from https://github.com/chaseoc/firebase-login-page

This project was bootstrapped with Create React App.

Features

Self Hosted using Firebase (Free plan)
Admin Panel for link management
Domain Customizable to anything you wish
Modern, Material UI (we all love this!)
Actively under development

Requirements

You'll need to make the following set up:

A Firebase project with Hosting (Free plan will work)
Add a Custom domain to your Firebase Hosting (you know, the shorter, the better)
Enable Email/Password authentication in your Firebase Authentication settings and set up your users.
Enable Firestore in the Firebase project.

Setup Guide Video

I went ahead and put all the installation steps into a video! You can watch the FireShort Setup Guide here -

https://www.youtube.com/watch?v=eVU0Wm3HLdM

How to Use

Clone the repo:

git clone https://github.com/xprilion/fireshort.git

Change working directory to project:

cd fireshort

Edit src/firebase/firebase.js and put your Firebase Project Config here:

const firebaseConfig = {
  //Your config values
};

Edit firebase.json and change hosting.site key:

...
"hosting": {
    "site":"yoursitename", <-- This is your firebase hosting site name
    "public": "build",
    ...

Edit src/config.js and update global.config.mainsite:

module.exports = global.config = {
    mainsite: "https://xprilion.com" <-- your main site here
    // other global config variables you wish
};

Local test run

npm start

Production build

npm run-script build

Deploy to Firebase

firebase --project **your_project_id** deploy

Configuration

The following configurations are available:

Parameter	Type	Description
globa.config.mainsite	URL	The site to which a blank suffix redirects. For ex: short.site -> long.site

Suggested Rules for Firebase Database

rules_version = '2';
service cloud.firestore {
  match /databases/{database}/documents {
    match /{document=**} {
      allow read : if true;
      allow write : if request.auth.uid != null;
    }
  }
}

Usage

Are you using FireShort for your URL shortener? Let me know! Feel free to put a PR with your details added to the table!

Website	Website short description	Person
xpri.dev	URL Shortener for xprilion.com	@xprilion

elevatedesigner/fireshort