Aura开源项目使用与部署教程

1. 项目介绍

Aura是一个为技术社区管理而设计的标准Web应用程序。它旨在帮助管理如GDG（Google Developer Groups）、DSC（Developer Student Clubs）等技术社区。Aura具备以下特点：

• 快速优化：符合Lighthouse标准的PWA（渐进式Web应用），可离线工作。
• 主题模式：支持亮色/暗色主题模式。
• 移动优先：为移动设备优化，可安装为手机原生应用。
• SEO优化：索引所有内容，帮助在搜索结果中排名靠前。
• 管理便捷：通过Aura Admin简化管理。
• 可用性：任何技术社区都可以使用。
• 定制事件页面：无需为每个事件创建单独的网站。
• 公共分享链接：为团队成员和演讲者提供公共URL，方便自我品牌建设和推广。

2. 项目快速启动

以下是快速启动Aura项目的步骤：

1. 安装Node.js（版本v8.9.4 - v12.13.0）。

2. 使用vue cli安装项目依赖：

   npm install -g @vue/cli
   

3. 克隆项目仓库，并安装项目依赖：

   git clone https://github.com/gdg-x/aura.git
   cd aura
   npm install
   

4. 设置Firebase项目。首先创建新Web应用，然后从Firebase控制台获取配置代码，更新src/config/firebase.js文件。

5. 运行项目：

   npm run serve
   

   首次运行可能会看到“网络连接不可用”或“网站未配置”的信息。

6. 构建生产环境：

   npm run build
   

   构建完成后，会在dist目录生成构建文件。

7. 部署到Firebase：

   • 安装Firebase CLI：

     npm i -g firebase-tools
     

   • 登录Firebase CLI：

     firebase login
     

   • 在aura-admin仓库的根目录下更新.firebasesrc文件中的Firebase项目ID。
   • 更新firebase.json文件，设置site键为你的Firebase托管ID。
   • 在项目根目录下构建并部署：

     firebase deploy
     

3. 应用案例和最佳实践

• 案例: GDG Jalandhar、DSC NSEC、GDG Konya等社区使用Aura进行社区管理。
• 最佳实践: 使用Aura Admin进行社区管理，确保使用相同的Firebase项目以便于维护。

4. 典型生态项目

Aura项目使用的典型技术栈包括VueJS、Vuetify、Firebase、Service Worker & PWA、Workbox等。这些技术共同构成了一个强大的生态系统，支持开发高效、响应式的Web应用。社区成员可以通过GitHub Issues参与项目的讨论、报告问题或提出新功能请求。