Frontend Setup Guide

This guide explains how to set up the frontend for development, production builds, and deployment.

Environment Variables

Create a .env file in the project root with the following variables:

VITE_PROJECT_NAME=
VITE_BACKEND_BASE_URL=
VITE_WS_BASE_URL=
VITE_APP_BASE_URL=
VITE_PLAUSIBLE_API=
VITE_PLAUSIBLE_DOMAIN=
VITE_BOT_USERNAME=
VITE_MINIAPP_SLUG=

⚠️ Replace each value with your own configuration.

Local Development

1. Install dependencies using Bun:

bun install

2. Start the development server:

bun run dev

This will start a Vite server, accessible via the host network.

Production Build

To build the frontend for production:

bun run build

The output will be in the dist/ folder, ready to serve with any static file server.

Deployment Options

1. GitHub Pages or Pages.dev

• Simply push your dist/ folder to a GitHub repository configured for Pages deployment.
• The frontend is fully static and works with any standard static hosting solution.