kittyFE

Front-end for the KittyURL project — create short and memorable URLs with ease!

Goals

Provide a responsive and modern user interface for:

• Account management (login, register, history, settings)
• Link creation (public landing page)
• Dashboard link management (for logged-in users)
• User management (admin panel)

KittyFE is built with Vite + React (TypeScript) to integrate seamlessly with kittyBE and is easily dockerizable.

Running kittyFE

KittyFE has been verified to work on Node v24.11.1.

On bare metal

Running the front-end is as simple as:

1. Install dependencies

   • To download the required dependencies:

     npm install
     

   • To install an exact copy of all dependencies (recommended for CI):

     npm ci
     

2. Configure environment variables

   Copy the .env.example file to .env and customize it to your preferences.

   Example: Tell the frontend where the backend API is located. Your .env file should look like this:

   VITE_API_TARGET=http://localhost:6567
   

   Important: All environment variables exposed to Vite must start with VITE_. Make sure the URL matches your running instance of kittyBE.

3. Launch the development server

   npm run dev
   

4. Open the app

   Visit:

   http://localhost:6568
   

   (or the port shown in your terminal output).

Building for production

To create an optimized static production build:

npm run build