Jelly-App项目安装与运行指南

Jelly-App项目安装与运行指南

jelly-app A lightweight & elegant music interface for Jellyfin. 项目地址: https://gitcode.com/gh_mirrors/je/jelly-app

项目概述

Jelly-App是一个基于现代前端技术栈开发的Web应用程序。该项目采用常见的JavaScript框架构建，通过Yarn作为包管理工具，为开发者提供了便捷的本地开发环境。

环境准备

在开始安装前，请确保您的系统已具备以下基础环境：

1. Git版本控制系统（用于代码克隆和版本管理）
2. Node.js运行环境（建议安装LTS版本）
3. Yarn包管理器（替代npm的快速、可靠依赖管理工具）

安装步骤详解

1. 获取项目代码

使用Git命令行工具执行以下命令克隆仓库：

git clone https://github.com/Stannnnn/jelly-app.git

2. 更新代码库

进入项目目录后，建议先同步最新代码：

cd jelly-app
git pull

3. 安装项目依赖

Yarn会自动解析package.json中的依赖项并安装：

yarn install

此过程会根据网络状况持续数秒到数分钟不等，将下载所有必要的开发和生产依赖。

4. 启动开发服务器

运行以下命令启动本地开发环境：

yarn dev

成功执行后，通常会显示本地服务器地址（如http://localhost:3000），在浏览器中访问即可查看实时开发版本。

开发建议

1. 首次运行建议检查控制台输出，确认无报错信息
2. 项目采用热重载技术，代码修改后会实时更新浏览器视图
3. 生产环境构建可使用yarn build命令

注意事项

• 确保Node.js版本符合项目要求（建议v14+）
• 如遇依赖冲突可尝试删除node_modules后重新安装
• Windows用户建议使用PowerShell或WSL环境执行命令

随着项目迭代，未来可能会提供Docker容器化方案或更简化的部署方式，开发者可持续关注项目更新。

jelly-app A lightweight & elegant music interface for Jellyfin. 项目地址: https://gitcode.com/gh_mirrors/je/jelly-app