# VitePressSimple

**Repository Path**: dicoder-cn/VitePressSimple

## Basic Information

- **Project Name**: VitePressSimple
- **Description**: VitePress Visual Configuration Tool
- **Primary Language**: Go
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: http://vpsimple.xiaod.co/zh
- **GVP Project**: No

## Statistics

- **Stars**: 7
- **Forks**: 3
- **Created**: 2024-03-11
- **Last Updated**: 2025-11-24

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

<div align="center">
<a href="https://github.com/zhangdi168/VitePressSimple">
<img src="./docs/vpstatic/images/vpsimple.png" width="120"/></a>
</div>

[//]: # (<h1 align="center">VitePress Simple</h1>)

<h3 align="center">
<a target="_blank" href="https://vitepress.dev/">VitePress</a> Configuration Tool</h3>

<h3 align="center">
<strong>English</strong> |
<a href="https://github.com/zhangdi168/VitePressSimple/blob/master/README_ZH.md">
简体中文</a>
</h3>

![vpsimple](./docs/vpstatic/images/demo.png)

[→→→ Quick Start Video Tutorial](https://www.bilibili.com/video/BV1ki421y7uV/#reply219109211424)

# Features
* Developed based on wails2+vite+vue3+typescript
* Lightweight client program based on Webview2
* Online editor for markdown documents
* Support for document directory tree, including moving, cutting, copying, and pasting operations
* Support for directly copying and pasting images into markdown documents and automatically uploading them to the server
* Native configuration parsing, directly parsing and rendering .vitepress/config.mts
* Multilingual support, different languages can be configured separately
* Navigation bar can be visually configured, and different languages can be separately configured
* Sidebar can be visually configured, supporting multiple sidebar configurations, multiple languages, and automatic sidebar recognition
* Search configuration support, optional local configuration or third-party search services


# Quick Start Guide

Free download for Mac and Windows installation packages:
[GitHub download link](https://github.com/zhangdi168/VitePressSimple/releases)
| [Gitee download link](https://gitee.com/zhangdi168/VitePressSimple/releases)

View the complete document：[Chinese Documentation](http://vpsimple.xiaod.co/zh) |
[English Documentation](http://vpsimple.xiaod.co/en)


Below is an example VitePress project for easy exploration:
## Create VitePress project
![Create VitePress project](./docs/vpstatic/images/20240416/9323bce8-7c90-439d-9b1b-49aec08211ea.png)

Enter the project name and select the project root directory:

![4631dcde70f7427bb5d07a2bd6d80b76.png](./docs/vpstatic/images/20240416/4631dcde-70f7-427b-b5d0-7a2bd6d80b76.png)
## online preview
![img.png](./docs/vpstatic/images/openInDir.png)

After the creation is completed, you can **click the folder icon to enter the project root directory** 

```bash
# Go to the project root directory, not the original directory
npm install
npm run docs:dev
```
After executing the above command, VitePress can be tested to run. The default address is: http://localhost:5173. Modifying the document content or configuration in vpsimple will automatically update.





## Build the Project

### Runtime Environment Requirements

* Go (latest version)
* Node.js >= 16
* NPM >= 9

### Install Wails

```bash
go install github.com/wailsapp/wails/v2/cmd/wails@latest
```

### Clone the Repository

```bash
git clone https://github.com/zhangdi168/VitePressSimple --depth=1
```

### Build the Frontend Code

```bash
cd ./frontend
npm install 
```

### Compile and Run the Development Version

```bash
# preview
wails dev

# build
wails build
```

### About the Author
[Author's Personal Website: http://xiaod.co/](http://xiaod.co/)

Author's Wechat:bcxiaod

This project is completely free. If it has been helpful to you, you can buy the author a coffee ☕️.