docs: add comprehensive English README and reorganize documentation

- Added detailed English README (README.en.md) with full project documentation
- Moved Chinese content to dedicated README.zh-CN.md file
- Updated main README.md to serve as language selector
- Expanded LICENSE file with complete PolyForm NonCommercial terms
- Improved documentation organization and navigation between language versions
- Added badges, links and consistent formatting across README files
- Included detailed sections

Author: Duri686

LICENSE

@@ -1,21 +1,56 @@
-RoadNet Visualizer
-
 SPDX-License-Identifier: PolyForm-Noncommercial-1.0.0
 
 Copyright (c) 2025 RoadNet Visualizer Contributors
 
-This software is licensed under the PolyForm Noncommercial License 1.0.0.
+PolyForm Noncommercial License 1.0.0
+
+Acceptance
+In order to get any license under these terms, you must agree to them as both strict obligations and conditions to all your licenses.
+
+Copyright License
+The licensor grants you a copyright license for the software to do everything you might do with the software that would otherwise infringe the licensor’s copyright in it for any permitted purpose. However, you may only distribute the software according to Distribution License and make changes or new works based on the software according to Changes and New Works License.
+
+Distribution License
+The licensor grants you an additional copyright license to distribute copies of the software. Your license to distribute covers distributing the software with changes and new works permitted by Changes and New Works License.
+
+Notices
+You must ensure that anyone who gets a copy of any part of the software from you also gets a copy of these terms or the URL for them above, as well as copies of any plain-text lines beginning with Required Notice: that the licensor provided with the software. For example:
+
+Required Notice: Copyright Yoyodyne, Inc. (http://example.com)
+
+Changes and New Works License
+The licensor grants you an additional copyright license to make changes and new works based on the software for any permitted purpose.
+
+Patent License
+The licensor grants you a patent license for the software that covers patent claims the licensor can license, or becomes able to license, that you would infringe by using the software.
+
+Noncommercial Purposes
+Any noncommercial purpose is a permitted purpose.
+
+Personal Uses
+Personal use for research, experiment, and testing for the benefit of public knowledge, personal study, private entertainment, hobby projects, amateur pursuits, or religious observance, without any anticipated commercial application, is use for a permitted purpose.
+
+Noncommercial Organizations
+Use by any charitable organization, educational institution, public research organization, public safety or health organization, environmental protection organization, or government institution is use for a permitted purpose regardless of the source of funding or obligations resulting from the funding.
+
+Fair Use
+You may have “fair use” rights for the software under the law. These terms do not limit them.
+
+No Other Rights
+These terms do not allow you to sublicense or transfer any of your licenses to anyone else, or prevent the licensor from granting licenses to anyone else. These terms do not imply any other licenses.
 
-You may not use the software for commercial purposes.
-You may copy, modify, and redistribute the software for noncommercial purposes, provided that you include the required notices.
+Patent Defense
+If you make any written claim that the software infringes or contributes to infringement of any patent, your patent license for the software granted under these terms ends immediately. If your company makes such a claim, your patent license ends immediately for work on behalf of your company.
 
-Full license text:
-https://polyformproject.org/licenses/noncommercial/1.0.0/
+Violations
+The first time you are notified in writing that you have violated any of these terms, or done anything with the software not covered by your licenses, your licenses can nonetheless continue if you come into full compliance with these terms, and take practical steps to correct past violations, within 32 days of receiving notice. Otherwise, all your licenses end immediately.
 
-简体中文说明（非正式译文）：
-- 仅允许在非商业目的下使用、复制、修改、分发本软件及其衍生作品；
-- 必须保留版权与许可证声明；
-- 严禁直接或间接商业用途；
-- 如需商业授权，请先取得版权所有者书面许可。
+No Liability
+As far as the law allows, the software comes as is, without any warranty or condition, and the licensor will not be liable to you for any damages arising out of these terms or the use or nature of the software, under any kind of legal claim.
 
-This is a summary. The English text of the PolyForm Noncommercial License 1.0.0 at the link above is the only legally binding version.
+Definitions
+The licensor is the individual or entity offering these terms, and the software is the software the licensor makes available under these terms.
+You refers to the individual or entity agreeing to these terms.
+Your company is any legal entity, sole proprietorship, or other kind of organization that you work for, plus all organizations that have control over, are under the control of, or are under common control with that organization. Control means ownership of substantially all the assets of an entity, or the power to direct its management and policies by vote, contract, or otherwise. Control can be direct or indirect.
+Your licenses are all the licenses granted to you for the software under these terms.
+Use means anything you do with the software requiring one of your licenses.

README.en.md

@@ -0,0 +1,179 @@
+# RoadNet Visualizer
+
+Multi-layer road network generator and visualizer built with Vite, PixiJS, and Web Workers. It supports path optimization (smoothing/orthogonalization), multi-layer navigation, interactive controls, export/share, and theming.
+
+[中文文档 | Chinese README](./README.zh-CN.md)
+
+[![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/Duri686/RoadNetVisualizer)
+![Deploy](https://github.com/Duri686/RoadNetVisualizer/actions/workflows/deploy.yml/badge.svg?branch=main)
+![Node](https://img.shields.io/badge/node-%3E=20-339933?logo=node.js&logoColor=white)
+![Vite](https://img.shields.io/badge/vite-5-646CFF?logo=vite&logoColor=white)
+![PixiJS](https://img.shields.io/badge/PixiJS-7-blueviolet)
+![License](https://img.shields.io/badge/license-NonCommercial-orange)
+![Stars](https://img.shields.io/github/stars/Duri686/RoadNetVisualizer?style=social)
+
+## Live Demo
+
+- GitHub Pages: [RoadNet Visualizer Demo](https://duri686.github.io/RoadNetVisualizer/)
+- Desktop and mobile supported. Latest Chrome/Edge recommended.
+
+## Table of Contents
+
+- [Features](#features)
+- [Preview](#preview)
+- [Getting Started](#getting-started)
+  - [Requirements](#requirements)
+  - [Local Development](#local-development)
+  - [Build & Deploy](#build--deploy)
+- [Core Concepts & Architecture](#core-concepts--architecture)
+- [Config Examples](#config-examples)
+- [Roadmap](#roadmap)
+- [Contributing](#contributing)
+- [FAQ](#faq)
+- [License](#license)
+- [Acknowledgments](#acknowledgments)
+
+## Features
+
+- Multi-layer road networks  
+  Centroid network, portal midpoints, Voronoi skeleton (experimental)
+- Path planning and optimization  
+  A* pathfinding; smoothing and orthogonalization; timing metrics
+- Interaction and navigation  
+  Zoom, pan, node picking, layer toggles, canvas navigation controls
+- Export and sharing  
+  One-click export and share
+- Mobile friendly  
+  Better touch experience
+- Performance & observability  
+  Index building, render init/total time, data size metrics
+- Themes & styles  
+  Dark/monochrome themes, componentized style system
+- Docs & help  
+  DeepWiki integration for quick knowledge lookup
+
+## Preview
+
+![Path Demo](docs/images/showPath.gif)
+![Overview](docs/images/overview.png)
+![Live Path Preview](docs/images/PathPreview.png)
+![Path Dynamic Planning](docs/images/PathDynamicPlanning.png)
+
+## Getting Started
+
+### Requirements
+
+- Node.js >= 20
+- Package manager: Yarn (via Corepack)
+- Browser: modern Chrome/Edge
+
+### Local Development
+
+```bash
+corepack enable
+yarn install --immutable
+
+# Start dev server
+yarn dev
+
+# Build
+yarn build
+
+# Preview (after build)
+yarn preview
+```
+
+### Build & Deploy
+
+- GitHub Pages workflow: `.github/workflows/deploy.yml`
+- Push to `main` triggers build and deploy of `dist/` to GitHub Pages
+- Vite `base: './'` is configured for sub-path and Pages compatibility
+
+## Core Concepts & Architecture
+
+- Multi-layer network building  
+  - Centroid network: skeleton nodes from regions/grids  
+  - Portal midpoints: cross-partition connections  
+  - Voronoi skeleton (experimental): alternative representation using Voronoi edges/points
+- Path planning & optimization  
+  - Pathfinding: A*  
+  - Optimization: smoothing, orthogonalization for straighter, smoother lines  
+  - Metrics: timing breakdown for pathfinding and optimization
+- Rendering & interaction  
+  - Rendering: PixiJS (WebGL)  
+  - Interaction: zoom/pan, node picking, layer toggles, canvas navigation controls  
+  - Animation: moving ball along path
+- Concurrency & performance  
+  - Web Workers: index/compute off main thread  
+  - Observability: index duration, render init, total time, data size
+
+> Project structure reference:
+
+```text
+src/
+├── core/                # rendering core (render/view/layers/interaction/config + workers)
+├── core/interaction/    # interaction modules (events/pipeline/animation)
+├── utils/               # utilities (navigation/geometry/path/index/export/share/state ...)
+│   └── navigation/      # navigation submodules (centroid/portal/voronoi/partition ...)
+├── components/          # UI components (forms, progress, layer control)
+├── css/                 # styles & themes (base/reset/tokens/utilities/layout/buttons/forms/...)
+└── main.js              # app entry
+```
+
+## Config Examples
+
+- Deploy: `vite.config.js` uses `base: './'`  
+- Build: `build.outDir = dist`, `build.sourcemap = true`  
+- Dev: `server.port = 3000`, `server.open = true`  
+- Worker: `worker.format = 'es'`
+
+> If you plan to expose runtime/algorithm configs (e.g., grid size, weights, sampling density, smoothing factor), export them under `src/core/config/` and document here.
+
+## Roadmap
+
+- [ ] More data formats for import/export (e.g., GeoJSON)
+- [ ] Richer weights/constraints (lanes/turns/restrictions/cost functions)
+- [ ] Enhanced optimization strategies (multi-objective/segmented)
+- [ ] Performance profiling panel and metric visualization
+- [ ] Unit tests and E2E coverage
+- [ ] i18n and accessibility (a11y)
+- [ ] More themes and visualization styles
+
+## Contributing
+
+- Branch model: feature/xxx -> PR to `main`
+- Conventions: Node 20 + Yarn, ESM, pass ESLint/Prettier
+- Steps:
+  1. Fork and create a feature branch
+  2. `corepack enable && yarn install --immutable`
+  3. `yarn dev` and ensure build passes
+  4. Open a PR with motivation and screenshots/diffs
+
+> Issues and suggestions are welcome.
+
+## FAQ
+
+- Blank page on Pages?  
+  `base: './'` is set. If still broken, clear cache or verify Pages settings (branch/path).
+- Node version?  
+  Node >= 20. Use official LTS and enable Yarn via Corepack.
+- Local preview URL?  
+  `http://localhost:3000/` (Vite dev server).
+- Performance unstable?  
+  Use hardware-accelerated browsers with WebGL; for large data, reduce sampling or load in batches.
+- DeepWiki not showing?  
+  Check network or use the provided documentation link directly.
+
+## License
+
+Licensed under the PolyForm Noncommercial License 1.0.0. See [LICENSE](./LICENSE) for details. Commercial use is prohibited. For commercial licensing, please open an Issue to contact us.
+
+## Acknowledgments
+
+- [PixiJS](https://pixijs.com/)
+- [d3-delaunay](https://github.com/d3/d3-delaunay)
+- [Turf.js](https://turfjs.org/)
+- Vite & GitHub Actions
+
+---
+Repository: [Duri686/RoadNetVisualizer](https://github.com/Duri686/RoadNetVisualizer)

README.md

@@ -1,66 +1,14 @@
 # RoadNet Visualizer
 
-基于 Vite + PixiJS + Web Workers 的多层道路网络可视化工具，支持路径优化、导航控件、导出分享与主题化。
+Multi-layer road network generator and visualizer (Vite + PixiJS + Web Workers)
 
-[![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/Duri686/RoadNetVisualizer)
-  
-## 功能特性
-- 生成多层道路网络：质心网络、Portal 中点、Voronoi 骨架（实验）
-- 路径优化：平滑与正交化，线条更顺更直，提供耗时统计
-- 交互与导航：缩放、平移、节点选取、图层开关与画布导航控件
-- 寻路与动画：A* 路径与动态小球动画
-- 导出与分享：一键导出与分享结果
-- 移动端适配：手机端操作更顺畅
-- 性能与可观测性：索引构建、渲染初始化/总耗时、数据体积等指标
-- 主题与样式：夜间/黑白主题，组件化样式体系
+## Language / 语言
 
-## 效果预览
+- English: [README.en.md](./README.en.md)
+- 简体中文: [README.zh-CN.md](./README.zh-CN.md)
 
-![RoadNet Visualizer 概览效果图](docs/images/overview.png)
-![RoadNet Visualizer 路径实时预览效果图](docs/images/PathPreview.png)
-![RoadNet Visualizer 路径动态规划效果图](docs/images/PathDynamicPlanning.png)
+## Quick Links
 
-## 本地开发
-```bash
-# 安装依赖（建议 Node.js 20+）
-corepack enable
-yarn install --immutable
-
-# 启动开发
-yarn dev
-
-# 构建产物
-yarn build
-```
-
-## 部署到 GitHub Pages
-本仓库已提供 Actions 工作流：`.github/workflows/deploy.yml`
-- 推送到 `main` 分支会自动构建并部署 `dist/` 到 Pages。
-- 如需自定义基础路径，已在 `vite.config.js` 使用 `base: './'` 便于 Pages 子路径访问。
-
-## 目录结构
-```
-src/
-├── core/                # 渲染核心（渲染/视图/图层/交互/配置 + Workers）
-├── core/interaction/    # 交互拆分模块（事件/管线/动画）
-├── utils/               # 工具库（导航/几何/路径/索引/导出/分享/状态 等）
-│   └── navigation/      # 导航子模块（质心/Portal/Voronoi/分区 等）
-├── components/          # UI 组件（表单、进度、图层控制）
-├── css/                 # 样式与主题（base/reset/tokens/utilities/layout/buttons/forms/...）
-└── main.js              # 应用入口
-```
-
-## 许可证（License）
-本项目以 **非商用许可证（Non-Commercial License）** 开源：
-- 允许任何人查看、分叉（fork）、修改与学习代码；
-- 允许在非商业目的下使用本项目及其派生作品；
-- **禁止任何形式的商业使用**（含直接或间接盈利、售卖、付费服务、企业内部商用等）；
-- 再分发时必须保留本声明及版权信息。
-
-如需商业授权，请通过 Issue 与我们联系。
-
-## 致谢
-- [PixiJS](https://pixijs.com/)
-- [d3-delaunay](https://github.com/d3/d3-delaunay)
-- [Turf.js](https://turfjs.org/)
-- Vite & GitHub Actions
+- Live Demo: [RoadNet Visualizer Demo](https://duri686.github.io/RoadNetVisualizer/)
+- License: [LICENSE](./LICENSE) (PolyForm Noncommercial 1.0.0)
+- Repository: [Duri686/RoadNetVisualizer](https://github.com/Duri686/RoadNetVisualizer)