Skip to content

Latest commit

 

History

History
226 lines (164 loc) · 9.23 KB

README.zh-CN.md

File metadata and controls

226 lines (164 loc) · 9.23 KB
Raw

Celeris Web

celeris-web - free and open-source front-end development framework
English| 简体中文

简介

Celeris Web是一个免费开源的前端开发框架，采用最新的技术，包括Vue 3、Vite和TypeScript。其monorepo方法使得依赖管理和多个项目的协作变得轻松，为开发人员提供了构建现代Web应用程序的全面解决方案。

无论您是经验丰富的开发人员还是刚刚入门，Celeris Web都提供了一个简化的前端开发流程，利用最新的工具和技术。

立即开始使用Celeris Web，并体验高度简化的前端开发流程，利用最新技术和高效的开发工具。

特点

编码风格

推荐的 IDE 设置

packages的依赖关系

 graph TD
   admin{admin}
   admin --> admin-api
   admin --> assets
   admin --> ca-components
   admin --> components
   admin --> constants
   admin --> directives
   admin --> hooks
   admin --> locale
   admin --> request
   admin --> styles
   admin --> types
   admin --> utils
   assets
   components
   components --> assets
   components --> ca-components
   components --> constants
   components --> styles
   components --> types
   components --> utils
   ca-components
   ca-components --> constants
   ca-components --> utils
   directives
   directives --> utils
   hooks
   hooks --> types
   locale
   locale --> constants
   locale --> types
   locale --> utils
   request
   request --> constants
   request --> locale
   request --> types
   request --> utils
   types
   types --> constants
   utils
   utils --> types
   admin-api
   admin-api --> constants
   admin-api --> types
Loading

要更新上面的图表，请编辑README文件，并在修改后打开一个新的PR。

中英文双语注释

在Celeris Web的设计中，我们注重代码的可读性和学习性，为此，我们为每个函数都配备了中英文双语注释，以确保无论您的母语是中文还是英文，都能轻松理解和学习代码。

为什么选择中英文双语注释？

  1. 全球协作： 在多语言团队中，中英文双语注释能够促进更好的沟通和协作，确保团队成员都能准确理解代码的功能和实现。

  2. 学习便捷： 对于新手来说，中英文双语注释提供了更友好的学习环境，帮助他们更快速地掌握代码的逻辑和结构。

  3. 开发者友好： 我们致力于构建一个开发者友好的开发环境，中英文双语注释是我们为实现这一目标而采取的一项关键措施。

  4. 示例：

/**
 * 打开一个新的浏览器窗口
 * Open a new browser window
 *
 * @param {string} url - 要在新窗口中打开的 URL
 * The URL to open in the new window
 *
 * @param {object} options - 打开窗口的选项
 * Options for opening the window
 * @param {string} options.target - 新窗口的名称或特殊选项，默认为 "_blank"
 * @param {string} options.features - 新窗口的特性（大小，位置等），默认为 "noopener=yes,noreferrer=yes"
 */
export function openWindow(url: string, { target = "_blank", features = "noopener=yes,noreferrer=yes" }: {
  target?: "_blank" | "_self" | "_parent" | "_top"; // 新窗口的名称或特殊选项，默认为 "_blank"
  features?: string; // 新窗口的特性（大小，位置等），默认为 "noopener=yes,noreferrer=yes"
} = {}) {
  window.open(url, target, features);
}

通过这样的中英文双语注释，我们希望为开发者提供更愉悦、更高效的编码体验，让Celeris Web成为一个真正容易上手和深入学习的前端模板。

Monorepo 设计的好处

1. 依赖管理更轻松： Monorepo 将所有项目的依赖项集中管理，避免了不同项目之间版本冲突的问题，使得整体的依赖管理更加清晰和简便。

2. 代码共享与重用： 不同项目之间可以方便地共享和重用代码，减少重复开发的工作量。这对于保持代码一致性和提高开发效率非常有利。

3. 统一的构建和部署： Monorepo 可以通过统一的构建和部署流程，简化整个开发过程，减少了配置和管理的复杂性，提高了开发团队的协作效率。

4. 统一的版本控制： 所有项目都在同一个版本控制仓库中，使得版本管理更加一致和可控。这有助于团队协同开发时更好地追踪和处理版本问题。

Monorepo设计让Celeris Web不仅是一款后台管理系统模板，同时也是一个快速开发C端产品的前端Web模板。有了Celeris Web，前端开发之路将更加轻松愉快！🚀

设计理念：突破Admin管理的局限性，关注C端用户体验

在市面上，大多数前端模板都着眼于满足B端用户的需求，为企业管理系统（Admin）提供了强大的功能和灵活的界面。然而，很少有模板将C端产品的特点纳入设计考虑，这正是我们Celeris Web的创新之处。

突破Admin管理的局限性：

传统的Admin管理系统更注重数据展示和业务管理，但C端产品更加侧重用户体验和视觉吸引力。我们深知C端用户对于界面美观、交互流畅的要求，因此Celeris Web不仅提供了强大的后台管理功能，更注重让前端界面在用户层面上达到更高水平。

关注C端用户体验：

Celeris Web不仅仅是一个后台管理系统的模板，更是一个注重C端用户体验的前端Web模板。我们致力于打破传统Admin系统的束缚，通过引入崭新的设计理念，使得C端产品在前端呈现上具备更为出色的用户体验。

特色亮点：

  • 时尚美观的UI设计： 我们注重界面的美感，采用现代化设计语言，使得Celeris Web的UI不仅仅是功能的堆

叠，更是视觉的享受。

  • 流畅的用户交互： C端用户对交互的要求往往高于B端，我们特别优化了界面的响应速度和交互效果，确保用户的每一次操作都能得到快速的反馈。

  • 多场景适配： 无论是用于电商、社交、还是内容展示，Celeris Web都提供了丰富的组件和模板，能够轻松适配各种C端应用场景。

快来试试吧！！

GitHub 模板

使用这个模板创建仓库.

克隆到本地

npx degit kirklin/celeris-web my-vite-app
cd my-vite-app
pnpm i

使用

开发

只需要执行以下命令就可以在 http://localhost:8888 中看到

pnpm run dev

构建

构建该应用只需要执行以下命令

pnpm run build

然后你会看到用于发布的 dist 文件夹被生成。

部署到 Netlify

前往 Netlify 并选择你的仓库, 一路 OK 下去，稍等一下后，你的应用将被创建.

Docker Production Build

首先，在项目的根目录下打开终端，构建celeris-web镜像。

docker buildx build . -t celeris-web:latest

运行镜像，用 "-p" 指定端口映射。

docker run --rm -it -p 8080:80 celeris-web:latest

Star History

Star History Chart