Frontend Execution

Qaintong6/19/25Less than 1 minute

I. Run Frontend (Start Frontend Service)

1. Modify Backend Service Port Configuration as Needed

// Vite configuration
server: {
  port: 80,
  host: true,
  open: true,
  proxy: {
    "/dev-api": {
      target: "http://localhost:8090",
      changeOrigin: true,
      rewrite: (p) => p.replace(/^\/dev-api/, ""),
    },
  }
}

2. Start Frontend Service

Step 1: Navigate to Project Directory

First, go to the qknow-ui directory:

# Enter project directory
cd qknow-ui

Step 2: Install Dependencies

Next, install the project dependencies. We recommend using the Taobao NPM registry mirror to speed up download speeds:

# Install dependencies (using Taobao mirror recommended)
npm install --registry=https://registry.npmmirror.com

Step 3: Start Development Server

Finally, run the following command to launch the frontend development server:

# Start project in development mode
npm run dev

Open a web browser and navigate to http://localhost. The default login credentials are qKnow/qKnow123. If the login page displays correctly, you can log in successfully, and menus and pages appear as expected, the environment setup is complete.

Tip: Since this project uses a fully separated frontend-backend architecture, both services must be running for full functionality.