newicon/neon-app

Neon框架的开发环境。

安装: 92

依赖关系: 0

建议者: 0

安全: 0

类型:项目

1.0.1 2020-11-11 13:51 UTC

This package is auto-updated.

Last update: 2024-09-12 10:55:36 UTC


README

此仓库用于基于neon和Yii2的应用程序开发。

安装

所需工具

Neon使用Composer来管理依赖项。请确保已安装composer。

npm对于tailwind的使用也是必需的。

供应商文件夹

创建供应商后,它将保存在您的仓库中。这是故意的,因为经验表明,用户错误意味着composer.lock在确保每个人都有相同的发展环境方面不如git可靠。

与处理不兼容或错误的供应商更新所浪费的时间相比,磁盘空间便宜。

此外,通过仓库历史记录跟踪更改和由第三方更新引起的问题也是可用的,这使得故障排除更容易。

node_modules通常不包括在仓库中,因为这些通常用于开发活动,而不是特定于项目。如果它们是特定的并且对于项目正常运行是必需的,请考虑将它们包括在仓库中。

Composer安装

在您的终端中运行以下命令以创建一个新的neon项目

composer create-project --prefer-dist newicon/neon-app my-project

手动安装

克隆此仓库并运行composer install。

git clone git@bitbucket.org:newicon/neon-app.git my-project
cd my-project
composer install
rm -rf .git

应用程序和代码访问

应用程序位于apps文件夹内部。默认为main。可以使用neon()->[app-name]访问Neon应用程序。例如

neon()->dds

来获取Daedalus。可以通过以下方式访问主应用程序的方法

main()->[some-method]

因为它已被添加到bootstrap.php中。如果您创建额外的应用程序并希望以类似的方式访问它们,请将它们添加到bootstrap文件中。这将有助于智能感知

模板

Neon使用tailwind css和laravel mix来编译javascript(Vue和Babel)和处理css。它使用postcss来编译tailwind css。

控制构建过程的laravel mix文件位于themes/default/webpack.mix.js

您必须安装node依赖项。转到:themes/default 在这里运行npm install

开发

npm run dev

这将从您的tailwind.config.js和css/main.css构建css,并将其放入assets/css/main.css请注意,模板资产文件夹已发布并可供公开使用。

自动运行构建

npm run watch

为了在文件更改时自动运行构建,请运行

为生产构建

npm run prod

此命令构建css和javascript,并创建相应的*.min文件。对于tailwind,这将运行purge css,删除所有未使用的css类。这一步骤通常会导致非常小的css文件。请注意,生产网站将使用压缩版本。如果您忘记检查压缩版本,则在推送到实时时可能看不到您的更改。

待办事项

  1. 创建一个npm run hot命令,当模板文件/ css/ js或配置文件更改时进行热重新加载。

  2. 在主题(或基础主题)中创建一些可重用的组件,这样我们就不必总是重新发明轮子。