Jetstrap 框架安装与使用指南

Jetstrap 框架安装与使用指南

1. 项目目录结构及介绍

以下是 Jetstrap 的主要目录结构：

jetstrap/
├── composer.json        # 项目依赖管理文件
├── src/                  # 包含Jetstrap的核心代码
│   └── NascentAfrica/
│       └── Jetstrap/     # 主要业务逻辑代码
├── resources/views/      # Laravel视图文件夹，存放Bootstrap定制后的模板
├── stubs/                # 骨架文件，用于生成新的组件或页面
├── test/                 # 测试目录
├── gitignore             # Git 忽略规则文件
└── ...

• composer.json: 用来定义项目及其依赖项，安装包时需参考此文件。
• src/NascentAfrica/Jetstrap: 存放Jetstrap的主要功能代码，包括对Jetstream和Breeze资源的切换。
• resources/views: 使用Bootstrap替换TailwindCSS后的视图文件，可以在此进行自定义编辑。
• stubs: 提供一些基本的模版，方便快速创建新页面或组件。
• test/: 测试目录，包含了项目的单元测试。

2. 项目的启动文件介绍

在Laravel中，启动文件通常位于public/index.php。在这个文件中，Laravel加载了Composer自动加载器并初始化应用实例。但Jetstrap本身并不提供特定的启动文件，它的操作主要是通过命令行工具来调用的，例如在php artisan 命令下运行 Jetstrap 的各种操作。

3. 项目的配置文件介绍

Jetstrap 并不直接包含自己的配置文件。然而，它会影响Laravel的默认配置，特别是对于Jetstream和Breeze的配置。例如，若要用Jetstrap将Jetstream的资源替换为Bootstrap，可能需要修改config/app.php中的服务提供者列表。确保NascentAfrica\Jetstrap\JetstrapServiceProvider已注册，这使得Jetstrap能够修改Jetstream的相关配置。

// config/app.php
'providers' => [
    // ...
    // Register Jetstrap ServiceProvider
    NascentAfrica\Jetstrap\JetstrapServiceProvider::class,
],

在使用过程中，可能会需要调整其他相关配置文件，比如webpack.mix.js（如果你使用Vite，则是相应的Vite配置）以适配Bootstrap的样式和脚本。具体改动取决于你的项目需求以及是否需要额外的前端构建步骤。

---

为了完成完整的安装和设置过程，需要执行以下步骤：

1. 安装 Jetstrap：

   composer require nascent-africa/jetstrap --dev
   

2. 根据需求选择Jetstream的堆栈（Livewire 或 Inertia）：

   php artisan jetstream:install {livewire|inertia} [--teams]
   

3. 更新前端依赖并编译：

   npm install && npm run dev
   

之后，就可以在项目中正常使用Jetstrap提供的Bootstrap化Jetstream资源了。如有任何问题，建议查阅官方仓库的Readme或其他文档资料。