{"id":23953811,"url":"https://github.com/sankeyangshu/lemon-template-react","last_synced_at":"2025-04-05T07:02:11.482Z","repository":{"id":154906440,"uuid":"626423560","full_name":"sankeyangshu/lemon-template-react","owner":"sankeyangshu","description":"A mobile web apps template based on the React ecosystem. 🎉 一个基于 React 生态系统的移动 web 应用模板。","archived":false,"fork":false,"pushed_at":"2025-03-20T05:39:46.000Z","size":780,"stargazers_count":168,"open_issues_count":0,"forks_count":6,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-29T06:01:51.437Z","etag":null,"topics":["axios","i18n-react","i18next","react","react-vant","template","typescript","unocss","vant","zustand"],"latest_commit_sha":null,"homepage":"https://lemon-template-react.vercel.app","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/sankeyangshu.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-04-11T12:48:17.000Z","updated_at":"2025-03-25T13:18:55.000Z","dependencies_parsed_at":null,"dependency_job_id":"e7bdb99f-9149-4a2e-9afa-73e1b59422c3","html_url":"https://github.com/sankeyangshu/lemon-template-react","commit_stats":{"total_commits":34,"total_committers":1,"mean_commits":34.0,"dds":0.0,"last_synced_commit":"05cebb949133285639c72a8217721e98eed7594a"},"previous_names":["sankeyangshu/react-template","sankeyangshu/lemon-template-react"],"tags_count":1,"template":true,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sankeyangshu%2Flemon-template-react","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sankeyangshu%2Flemon-template-react/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sankeyangshu%2Flemon-template-react/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sankeyangshu%2Flemon-template-react/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sankeyangshu","download_url":"https://codeload.github.com/sankeyangshu/lemon-template-react/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247299829,"owners_count":20916190,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["axios","i18n-react","i18next","react","react-vant","template","typescript","unocss","vant","zustand"],"created_at":"2025-01-06T14:46:38.020Z","updated_at":"2025-04-05T07:02:11.455Z","avatar_url":"https://github.com/sankeyangshu.png","language":"TypeScript","funding_links":[],"categories":["TypeScript"],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\u003ca href=\"https://github.com/sankeyangshu/lemon-template-react\"\u003e\n  \u003cimg alt=\"Lemon-Template-React\" width=\"200\" height=\"200\" src=\"./public/logo.png\"\u003e\n\u003c/a\u003e\n\n\u003ch1 align=\"center\"\u003e\n  lemon-template-react\n\u003c/h1\u003e\n\nEnglish / [简体中文](./README.zh-CN.md)\n\nAn mobile web apps template based on the React ecosystem.\n\n\u003cp\u003e\n  \u003cimg src=\"https://img.shields.io/github/license/sankeyangshu/lemon-template-react\" alt=\"license\" /\u003e\n  \u003cimg src=\"https://img.shields.io/github/package-json/v/sankeyangshu/lemon-template-react\" alt=\"version\" /\u003e\n  \u003cimg src=\"https://img.shields.io/github/languages/top/sankeyangshu/lemon-template-react\" alt=\"languages\" /\u003e\n  \u003cimg src=\"https://img.shields.io/github/repo-size/sankeyangshu/lemon-template-react\" alt=\"repo-size\" /\u003e\n  \u003cimg src=\"https://img.shields.io/github/issues-closed/sankeyangshu/lemon-template-react\" alt=\"issues\" /\u003e\n\u003c/p\u003e\n\n[Docs](https://sankeyangshu.github.io/lemon-template-docs/react/) / [Feedback](https://github.com/sankeyangshu/lemon-template-react/issues)\n\n\u003c/div\u003e\n\n---\n\n## Introduction\n\n🚀🚀🚀 **lemon-template-react** is built using the latest technologies, including `React18`, `Vite6`, `react-vant`, `Zustand`, `TypeScript`, and `UnoCSS`. It integrates features like `Dark Mode`, system theme colors, and Mock data.\n\nYou can directly start developing your business logic on this template! Hope you enjoy it. 👋👋👋\n\n\u003e [!NOTE]\n\u003e If this project is helpful to you, please click the \"Star\" button in the top-right corner. Thank you!\n\n## Preview\n\n👓 [Click Demo](https://lemon-template-react.vercel.app) (Switch to mobile view on PC browsers)\n\n## Other Templates\n\n- [lemon-template-vue](https://github.com/sankeyangshu/lemon-template-vue) - A mobile web apps template based on the Vue 3 ecosystem\n- [lemon-template-uniapp](https://github.com/sankeyangshu/lemon-template-uniapp) - An mobile web apps template based on the UniApp ecosystem\n\n## Features\n\n- ⚡️ Developed with React + Hooks\n- ✨ Uses Vite 6 as the development and build tool (includes Gzip packaging, TSX syntax, proxy support, etc.)\n- 🍕 Fully integrates TypeScript\n- 🍍 Use Zustand for state management, lightweight, simple and easy to use\n- 📦 ahooks High quality and reliable React Hooks library\n- 🎨 react-vant component library\n- 🌀 UnoCSS for instant atomic CSS\n- 👏 Integrates multiple icon solutions\n- 🌓 Supports Dark Mode\n- 🌍 Multi-language support with i18n\n- 🔥 ECharts for data visualization, with useECharts Hooks\n- ⚙️ Unit testing using Vitest\n- ☁️ Axios encapsulation\n- 💾 Local Mock data support\n- 📱 Browser compatibility with viewport vw/vh units for layouts\n- 📥 Gzip compression for packaged resources\n- 🛡️ Splash screen animation for first load\n- 💪 Eslint for code linting, with Prettier for formatting\n- 🌈 Uses simple-git-hooks, lint-staged, and commitlint for commit message standards\n\n## Prerequisites\n\nFamiliarity with the following concepts will help you use this template effectively:\n\n- [React](https://react.dev/) - Familiar with `React` basic syntax\n- [Vite](https://cn.vitejs.dev/) - Understand `Vite` features\n- [Zustand](https://docs.pmnd.rs/zustand/getting-started/introduction) - Proficient in using `Zustand`\n- [TypeScript](https://www.typescriptlang.org/) - Master basic `TypeScript` syntax\n- [React-Router](https://reactrouter.com/en/main) - Understand `React-Router` usage\n- [Icones](https://icones.js.org/) - Recommended icon library for the project, but `IconSVG` is also an option\n- [UnoCSS](https://github.com/antfu/unocss) - High-performance and flexible atomic CSS engine\n- [ahooks](https://ahooks.js.org/zh-CN/) - A reliable and high-quality React Hooks library\n- [React Vant](https://react-vant.3lang.dev/) - Lightweight and reliable mobile React component library\n- [ECharts5](https://echarts.apache.org/handbook/zh/get-started/) - Familiar with basic `ECharts` usage\n- [Mock.js](https://github.com/nuysoft/Mock) - Understand basic `Mock.js` syntax\n- [ES6+](http://es6.ruanyifeng.com/) - Proficient in `ES6+` syntax\n\n## Environment Setup\n\nEnsure the following tools are installed locally: [Pnpm](https://pnpm.io/), [Node.js](http://nodejs.org/), and [Git](https://git-scm.com/).\n\n- Use [pnpm \u003e= 8.15.4](https://pnpm.io/) to avoid dependency installation and build errors.\n- [Node.js](http://nodejs.org/) version `18.x` or above is required. Recommended: `^18.18.0 || \u003e=20.0.0`.\n\n## VSCode Extensions\n\nIf you use [VSCode](https://code.visualstudio.com/) (recommended), install the following extensions for improved efficiency and code formatting:\n\n- [UnoCSS](https://marketplace.visualstudio.com/items?itemName=antfu.unocss) - UnoCSS support\n- [DotENV](https://marketplace.visualstudio.com/items?itemName=mikestead.dotenv) - `.env` file highlighting\n- [Error Lens](https://marketplace.visualstudio.com/items?itemName=usernamehw.errorlens) - Better error visualization\n- [EditorConfig for VS Code](https://marketplace.visualstudio.com/items?itemName=EditorConfig.EditorConfig) - Maintain consistent coding styles across IDEs\n- [ESLint](https://marketplace.visualstudio.com/items?itemName=dbaeumer.vscode-eslint) - Script linting\n- [i18n Ally](https://marketplace.visualstudio.com/items?itemName=lokalise.i18n-ally) - All-in-one i18n support\n- [JavaScript and TypeScript VSCode Snippets](https://marketplace.visualstudio.com/items?itemName=sankeyangshu.vscode-javascript-typescript-snippets) - Visual Studio Code snippets for JavaScript and TypeScript\n- [React Collection VSCode Snippets](https://marketplace.visualstudio.com/items?itemName=sankeyangshu.vscode-react-collection-snippets) - A React Code Snippets Extension\n\n## Usage\n\n### Use the Scaffold\n\n\u003e In development\n\n### GitHub Template\n\n[Use this template to create a repository](https://github.com/sankeyangshu/lemon-template-react/generate)\n\n### Clone\n\n```bash\n# Clone the project\ngit clone https://github.com/sankeyangshu/lemon-template-react.git\n\n# Enter the project directory\ncd lemon-template-react\n\n# Install dependencies (use pnpm)\npnpm install\n\n# Start the development server\npnpm dev\n\n# Build for production\npnpm build\n```\n\n## Git Commit Guidelines\n\n### Commit Standards\n\nThe project enforces Git commit messages using `simple-git-hooks` and `commitlint`, adhering to the widely adopted [Angular](https://github.com/conventional-changelog/conventional-changelog/tree/master/packages/conventional-changelog-angular) guidelines.\n\n- `feat`: Add new features\n- `fix`: Fix bugs\n- `docs`: Documentation changes\n- `style`: Code formatting (does not affect functionality, e.g., spacing, semicolons, etc.)\n- `refactor`: Code refactoring (neither bug fixes nor new features)\n- `perf`: Performance optimizations\n- `test`: Add or update test cases\n- `build`: Changes to build process or external dependencies (e.g., updating npm packages, modifying webpack configuration)\n- `ci`: Changes to CI configuration or scripts\n- `chore`: Changes to build tools or auxiliary libraries (does not affect source files or tests)\n- `revert`: Revert a previous commit\n\n## Community\n\nYou can use [issues](https://github.com/sankeyangshu/lemon-template-react/issues) to report problems or submit a Pull Request.\n\n## Browser Support\n\n- For local development, we recommend using the latest version of Chrome. [Download](https://www.google.com/intl/en/chrome/).\n- The production environment supports modern browsers. IE is no longer supported. For more details on browser support, check [Can I Use ES Module](https://caniuse.com/?search=ESModule).\n\n| [\u003cimg src=\"https://i.imgtg.com/2023/04/11/8z7ot.png\" alt=\" IE\" width=\"24px\" height=\"24px\" /\u003e](http://godban.github.io/browsers-support-badges/)\u003c/br\u003eIE | [\u003cimg src=\"https://raw.githubusercontent.com/alrra/browser-logos/master/src/edge/edge_48x48.png\" alt=\" Edge\" width=\"24px\" height=\"24px\" /\u003e](http://godban.github.io/browsers-support-badges/)\u003c/br\u003eEdge | [\u003cimg src=\"https://raw.githubusercontent.com/alrra/browser-logos/master/src/firefox/firefox_48x48.png\" alt=\"Firefox\" width=\"24px\" height=\"24px\" /\u003e](http://godban.github.io/browsers-support-badges/)\u003c/br\u003eFirefox | [\u003cimg src=\"https://raw.githubusercontent.com/alrra/browser-logos/master/src/chrome/chrome_48x48.png\" alt=\"Chrome\" width=\"24px\" height=\"24px\" /\u003e](http://godban.github.io/browsers-support-badges/)\u003c/br\u003eChrome | [\u003cimg src=\"https://raw.githubusercontent.com/alrra/browser-logos/master/src/safari/safari_48x48.png\" alt=\"Safari\" width=\"24px\" height=\"24px\" /\u003e](http://godban.github.io/browsers-support-badges/)\u003c/br\u003eSafari |\n| :----------------------------------------------------------------------------------------------------------------------------------------------------: | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: |\n|                                                                      not support                                                                       |                                                                                            last 2 versions                                                                                             |                                                                                                  last 2 versions                                                                                                  |                                                                                                last 2 versions                                                                                                |                                                                                                last 2 versions                                                                                                |\n\n## License\n\n[MIT](./LICENSE) License © 2023-PRESENT [sankeyangshu](https://github.com/sankeyangshu)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsankeyangshu%2Flemon-template-react","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsankeyangshu%2Flemon-template-react","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsankeyangshu%2Flemon-template-react/lists"}