FunCode Scratch Editor is an ultra-lightweight open-source graphical programming system for children that can serve as a replacement for the desktop version of the Scratch editor. Compared with other open-source Scratch systems, its main feature is extremely simple deployment: it uses an SQlite file database, requires no configuration, and users only need to download and run the program to provide a complete service including user management and Scratch graphical programming on their local computer. The system is compatible with mainstream operating systems such as Windows, Linux, and Mac, and is especially suitable for individuals or small children's programming training institutions.
This project is still under development. If you are interested, you are welcome to join and improve it together.
Currently, there is a QQ group: 749870231. Welcome to join and discuss.
Download address: https://github.com/mail2fish/fun_code/releases
After running the program, a funcode_server directory will be automatically created to store service configuration information and students' program files.
It is recommended to place the funcode program in a separate directory for unified management of related files.
Open the terminal, go to the directory where the funcode program is located, and execute the following commands:
Note: Please replace ./funcode_darwin_arm64 in the command with the actual downloaded program name.
chmod +x ./funcode_darwin_arm64
./funcode_darwin_arm64
After the program runs normally, the interface is as shown below:
On the first run, an administrator account will be automatically created. The username is admin, and the password will be prompted once in the terminal. You can later check the default password in the funcode_server/config/config.yaml file. If you change the password in the admin panel later, the default password will become invalid.
In addition, on the first run, the default listening port is 8080. If port 8080 is already occupied, the program will automatically increment the port number and try other available ports (such as 8081).
Open your browser and visit the address shown in the terminal to access the service.
After logging in, you will enter the admin panel, where you can manage students, projects, classes, and other information.
Click the "New Scratch Project" button in the interface to enter the Scratch graphical programming system.
In the admin panel, click the "Create User" button to open the new user interface.
- Go 1.24+
- NodeJs 23.9.0+
Get help information
make help
Available make commands:
all - 构建所有平台的项目
clean - 清理构建文件
deps - 安装 Go 依赖
frontend-deps - 安装前端依赖
build-go-all - 构建所有平台的 Go 项目
build-go-{os}-{arch} - 构建指定平台的 Go 项目
build-frontend - 构建 React 前端
build-scratch - 构建 Scratch 项目
dev - 运行 Go 开发服务器
dev-frontend - 运行前端开发服务器
dev-scratch - 运行 Scratch 开发服务器
test - 运行 Go 测试
test-frontend - 运行前端测试
test-scratch - 运行 Scratch 测试
fmt - 格式化代码
lint - 检查代码质量
help - 显示帮助信息
支持的平台和架构组合:
windows-amd64 - Windows 64位
linux-amd64 - Linux 64位
darwin-amd64 - macOS Intel
darwin-arm64 - macOS ARM
The generated executable files are in the build directory.
The project is divided into two parts: the server and the web client.
You must build the client before building the server; otherwise, even if the server is built successfully, it will not work due to the lack of the frontend.
The client code is mainly in the web directory, including two parts: scratch and react-router-www.
scratch is the client code for the Scratch graphical programming system, and react-router-www is the client code for the student management system.
Install NodeJs
The code is in the web/scratch directory. This part simply wraps the Scratch GUI API to build an interface.
Before building web/scratch, you need to build Scratch GUI first.
Note: Do not use npm to install scratch-gui, because some code has been modified, so you need to build from source.
git clone https://github.com/mail2fish/scratch-gui/
git checkout -b main_fun_code origin/main_fun_code
cd scratch-gui
npm install
BUILD_MODE=dist npm run build
npm link
mail2fish/scratch-gui/ is a forked and customized version from https://github.com/scratchfoundation/scratch-gui. Its develop branch will be synchronized with the original repository.
Note: Use the project's main_fun_code branch.
Build static files
cd web/scratch
npm link scratch-gui
npm install
npm run build
Start dev environment
cd web/scratch
npm link scratch-gui
npm start
The code is in the web/react-router-www directory. This is a student management system developed based on ReactRouter and shadcn.
The project uses React-Router, so you need to install React-Router
Build static files
cd web/react-router-www
npm install
npm run build
Start dev environment
cd web/react-router-www
npm install
npm run dev
The server is developed in Go, based on Gin and GORM frameworks, and uses SQLite database.
The code is mainly in the internal directory.
go mod tidy
go build -o ./fun_code ./cmd/fun_code/main.go
You only need to run go build to build the program.
After the build is complete, an executable file will be generated. Run this file to start the server.
Used to manage the service as a daemon process.
https://github.com/ochinchina/supervisord
Do not run as root. Refer to deploy/supervisord.conf for configuration.
sudo sysctl net.ipv4.ip_forward=1
# To make it permanent, edit /etc/sysctl.conf or create a new file under /etc/sysctl.d/, add:
# net.ipv4.ip_forward = 1
# Then run sudo sysctl -p
sudo iptables -t nat -A PREROUTING -p tcp --dport 80 -j REDIRECT --to-port 8080
If you want to forward port 80 from localhost to 8080, you also need to add an OUTPUT chain rule:
sudo iptables -t nat -A OUTPUT -p tcp -d 127.0.0.1 --dport 80 -j REDIRECT --to-port 8080
# For IPv6 (if needed):
# sudo ip6tables -t nat -A PREROUTING -p tcp --dport 80 -j REDIRECT --to-port 8080
# sudo ip6tables -t nat -A OUTPUT -p tcp -d ::1 --dport 80 -j REDIRECT --to-port 8080
sudo apt update
sudo apt install iptables-persistent
# During installation, you will be prompted whether to save the current IPv4 and IPv6 rules, select "Yes".
# If you modify the rules later, you need to save them manually:
sudo netfilter-persistent save
Using sqlite requires installing cgo.