README.md

metadata

title: VvvebJs Website Builder
emoji: 🎨
colorFrom: blue
colorTo: purple
sdk: docker
pinned: false
license: apache-2.0

VvvebJs - Visual Website Builder

Features

• 🎨 Visual drag & drop interface
• 📱 Bootstrap 5 components
• 💾 GitHub & EdgeOne KV storage
• 👥 GitHub-based user management with real-time sync
• 🔄 Undo/Redo functionality

🔄 GitHub User Management System

系统使用基于GitHub的用户管理，确保用户数据在多个实例间实时同步。

主要特性

• ✅ 实时同步： 每次登录都从GitHub仓库加载最新用户数据
• ✅ 数据持久化： 用户数据存储在GitHub仓库的 system/users.json 文件中
• ✅ 多实例同步： 多个部署实例间自动共享用户数据
• ✅ 安全性： 密码使用 PHP password_hash() 加密存储
• ✅ 向下兼容： 保持与原有环境变量用户系统的兼容性

用户数据存储位置

• GitHub模式： https://github.com/YOUR_OWNER/YOUR_REPO/blob/main/system/users.json
• 环境变量模式： 通过 USER_1_NAME、USER_1_PASSWORD 等环境变量配置

Configuration

Set these environment variables in Space Settings:

Authentication (Required)

USER_1_NAME=admin
USER_1_PASSWORD=your_secure_password
USER_2_NAME=editor
USER_2_PASSWORD=another_password

Storage Configuration

STORAGE_TYPE=github

GitHub Storage (Recommended)

GITHUB_TOKEN=ghp_your_github_token
GITHUB_OWNER=your_username
GITHUB_REPO=your_repo_name
GITHUB_BRANCH=main
GITHUB_PATH=pages/

EdgeOne KV Storage (Optional)

EDGEONE_KV_API_KEY=your_api_key
EDGEONE_KV_SECRET_KEY=your_secret_key
EDGEONE_KV_ZONE_ID=your_zone_id

User Management Modes

1. GitHub User Management (默认)

• 用户通过GitHub仓库中的用户数据登录
• 支持密码修改功能
• 多实例间自动同步
• 访问 login.html 进行登录

2. Environment Variable Mode (备用)

• 通过环境变量预配置用户
• 使用Basic Authentication
• 适合简单部署场景

Usage

1. Access the Space URL
2. Login with existing account:
   • GitHub Mode: Visit login.html to login
   • Env Mode: Use configured username/password
3. Build your website visually
4. Pages are saved to external storage automatically

File Structure

system/
└── users.json          # GitHub-managed user data

users/
├── username1/
│   ├── page1.html
│   └── page2.html
└── username2/
    ├── index.html
    └── about.html

User Account Management

User accounts are managed through the GitHub repository. To add new users:

1. Manually add user data to system/users.json in the GitHub repository
2. Use proper password hashing for security
3. System will automatically load the updated user data on next login

Development

The system uses a hybrid approach:

• Priority 1: GitHub user management for data persistence
• Fallback: Environment variable authentication for compatibility
• Storage: All user files stored with user isolation

License

Apache License 2.0