GardenPulse README

项目的 README,来自 github.com/AhmadHassan-BTed/GardenPulse。合并为一个 markdown 文件:README.md。

GardenPulse - Grow Smarter, Anywhere

Expo SDK 54 React Native TypeScript Firebase Gemini AI License Proprietary

The first method-agnostic garden assistant - soil, hydro, container, or indoor - with location-aware intelligence, on-device AI diagnostics, and privacy-first automation.


What is GardenPulse?

GardenPulse is a smart urban garden companion that eliminates the guesswork out of growing. Whether you're tending windowsill herbs, managing a balcony container garden, running a hydroponic setup, or maintaining 50+ houseplants - GardenPulse adapts every recommendation to your specific growing method, your local climate, and your live weather conditions.

Tagline: Grow Smarter, Anywhere.

Unlike generic plant apps, GardenPulse is method-agnostic: the entire UI, care schedule, and AI guidance adapts based on how you grow - not a one-size-fits-all template. Core tools are 100% free, forever, with a privacy-first, offline-capable architecture.


Key Features

AI-Powered Intelligence

Feature Description
Method-Agnostic Plant ID Snap a leaf → AI detects plant species, growing method, and likely issues (deficiency, pest, overwatering)
Localized AI Agronomist On-device ML evaluates leaf patterns against user-logged metrics and regional climate data
Smart Weather Integration Auto-adjusts care schedules based on live forecast (e.g., "Rain tomorrow → skip watering today")
Gemini Vision Diagnostics All leaf-scan diagnostics run on-device - photos are never uploaded to the cloud

Location & Context Intelligence

Feature Description
GPS / Network Location Enables hyper-local plant recommendations and regional pest/disease alerts
Auto Planting Zone Detection USDA Hardiness Zone auto-detect filters the plant database to region-survivable species
Live Weather API OpenWeatherMap One Call API 3.0 for real-time temp, humidity, precipitation, and UV index
Local Community Maps Opt-in anonymized data shows what's thriving in your ZIP code right now

Smart Scheduling & Automation

Camera & Media Tools

Analytics & Personalization

Monetization (AdMob Optimized)

Ad Type Trigger Target eCPM
High-Intent Interstitial Triggered at dosing calculation / export moments $25–45 (Tier 1)
Contextual Native Ads Styled as "Garden Tips" within the activity timeline -
Rewarded Videos Unlock PDF garden plans, compliance logs, advanced calculators -
Supporter Badge $2.99 one-time to remove interstitials only -

Community & Viral Features


Technology Stack

Layer Technology Version
Mobile Framework React Native + Expo SDK 54.0.35 (RN 0.81.5)
Language TypeScript ~5.9.2
UI Components React Native Paper (Material Design) ^5.15.3
Glassmorphic UI @callstack/liquid-glass + expo-blur ^0.8.0 / ~15.0.8
Icons @expo/vector-icons ^15.0.3
Backend & Auth Firebase Auth, Firestore, Storage ^12.14.0
AI Engine Google AI Studio - Gemini Multimodal & Vision ^0.24.1
Location expo-location + Google Maps Platform ~19.0.8
Maps react-native-maps 1.20.1
Weather OpenWeatherMap One Call API 3.0 -
Camera expo-camera ~17.0.10
Media expo-image-picker, expo-media-library -
Audio expo-av ~16.0.8
Offline Storage @react-native-async-storage/async-storage 2.2.0
State Management Zustand ^5.0.14
Monetization Google AdMob (react-native-google-mobile-ads) ^16.3.3
Vector Graphics react-native-svg 15.12.1

Project Structure

GardenPulse/
├── .agents/                  # Local AI agent skills (excluded from Git)
│   └── skills/               # Skillfish-managed agent skill packs
├── .claude/                  # Claude AI assistant context files
├── .docs/                    # Product blueprint & tech stack documents
│   └── Gardenpulse .md       # Full product specification
├── .expo/                    # Expo local build cache (auto-generated)
├── assets/                   # App icons, splash screens, banner assets
│   ├── banner-app-logo.png   # App banner (used in README)
│   ├── icon.png              # App icon (iOS)
│   ├── favicon.png           # Web favicon
│   ├── android-icon-foreground.png
│   ├── android-icon-background.png
│   └── android-icon-monochrome.png
├── App.tsx                   # Root application component
├── index.ts                  # Expo entry point
├── app.json                  # Expo config - permissions, plugins, AdMob IDs
├── metro.config.js           # Custom Metro bundler configuration
├── tsconfig.json             # TypeScript compiler settings
├── package.json              # Dependencies & npm scripts
├── INSTALL.md                # Detailed setup guide for all APIs & credentials
├── Architecture.drawio       # System architecture diagram
├── GARDENPULSE.md            # Product blueprint (markdown mirror)
├── AGENTS.md                 # Agent / AI assistant guidelines
├── CLAUDE.md                 # Claude assistant context
└── LICENSE                   # Proprietary License

Quick Start

Prerequisites

Ensure the following are installed on your machine:

Tool Minimum Version Notes
Node.js v18.x or v20.x LTS recommended
npm v9.x or later Bundled with Node
Git Any recent version For cloning
Expo Go Latest iOS / Android device app for development
Android Studio Optional For Android Emulator
Xcode Optional (macOS only) For iOS Simulator

1. Clone & Install

git clone <repository-url>
cd GardenPulse
npm install

2. Configure Environment Variables

Create a .env file in the project root and populate it with your API keys:

# ── Google AI Studio (Gemini) ───────────────────────────────
EXPO_PUBLIC_GEMINI_API_KEY=your_gemini_api_key_here

# ── OpenWeatherMap ──────────────────────────────────────────
EXPO_PUBLIC_OPENWEATHER_API_KEY=your_openweather_api_key_here

# ── Firebase ────────────────────────────────────────────────
EXPO_PUBLIC_FIREBASE_API_KEY=your_firebase_api_key_here
EXPO_PUBLIC_FIREBASE_AUTH_DOMAIN=your_project_id.firebaseapp.com
EXPO_PUBLIC_FIREBASE_PROJECT_ID=your_project_id
EXPO_PUBLIC_FIREBASE_STORAGE_BUCKET=your_project_id.appspot.com
EXPO_PUBLIC_FIREBASE_MESSAGING_SENDER_ID=your_messaging_sender_id
EXPO_PUBLIC_FIREBASE_APP_ID=your_firebase_app_id
EXPO_PUBLIC_FIREBASE_MEASUREMENT_ID=your_measurement_id

Note: Google Maps API keys are embedded in app.json under the Android/iOS config sections. See INSTALL.md for details.


3. Run the Development Server

npm run start       # Start Expo dev server (scan QR with Expo Go)
npm run android     # Launch on Android emulator / connected device
npm run ios         # Launch on iOS simulator (macOS only)
npm run web         # Launch web version in browser

Scan the QR code in the terminal with the Expo Go app on your physical device to preview the app instantly.


API Keys & Service Setup

Service Where to Get It Docs
Gemini AI Google AI Studio Free tier available
OpenWeatherMap openweathermap.org One Call API 3.0
Firebase Firebase Console Auth + Firestore + Storage
Google Maps Google Cloud Console Maps SDK for Android/iOS
AdMob AdMob Console Test IDs pre-configured

The project ships with Google's standard AdMob test IDs so you can build and test ads immediately without a real AdMob account.


Production Build (Google Play Store)

# 1. Install EAS CLI
npm install -g eas-cli

# 2. Log in to Expo
eas login

# 3. Configure EAS project (first time only)
eas build:configure

# 4. Build production Android App Bundle (.aab)
eas build --platform android --profile production

The .aab output is ready for direct upload to the Google Play Console.

For full deployment instructions including iOS App Store builds, keystore management, and AdMob production ID configuration, see INSTALL.md.


UX & Design Philosophy


Privacy & Compliance

GardenPulse is designed with a privacy-first architecture:


Roadmap

Phase Feature
MVP Core logging, AI diagnostics, weather scheduling, AdMob
Phase 2 GardenPulse for Schools - STEM curriculum modules
Phase 3 Hardware integrations - Bluetooth sensors, smart irrigation
Phase 4 B2B white-label - Nurseries & seed brands
Phase 5 Certification pathways - Urban ag nonprofit partnerships

Documentation

Document Description
INSTALL.md Full setup guide - API keys, Firebase config, AdMob IDs, Play Store deployment
GARDENPULSE.md Complete product blueprint - features, UX flows, monetization model
Architecture.drawio System architecture diagram (open with draw.io)

License

This project is proprietary and confidential. All rights are reserved. See the LICENSE file for details.


Built with by the GardenPulse team  ·  Grow Smarter, Anywhere.

GardenPulse (AhmadHassan-BTed/GardenPulse)

正在搜索数据库…

这是什么?GardenPulse 是一款移动端园艺助手应用,它会根据你实际的种植方式(土培、水培、容器栽培或室内种植)调整整个界面、养护日程和 AI 指导,而不是套用千篇一律的植物养护模板。
这是原生应用还是网页工具?它是一款使用 React Native、Expo 和 TypeScript 开发的原生移动应用,可直接在 iOS 和 Android 设备上运行,而不是在浏览器中运行。
我该怎么让它运行起来?克隆仓库,运行 npm install,创建 .env 文件并填入你的 API 密钥,然后启动 Expo 开发服务器,用 Expo Go 应用扫描二维码,即可在你的设备上预览。
运行之前需要先安装什么?你需要安装 Node.js v18 或 v20、npm v9+、Git,并在手机上安装 Expo Go 应用;Android Studio 和 Xcode 用于模拟器,属于可选项。你还需要获取 Gemini AI、OpenWeatherMap、Firebase、Google Maps 和 AdMob 的 API 密钥。
AdMob 配置能直接用于正式环境吗?项目内置了 Google 标准的 AdMob 测试 ID,因此广告可以直接构建和运行;但在发布前,你需要替换为自己的正式 AdMob ID,具体步骤见 INSTALL.md。
我扫描叶片时,植物照片会传到哪里?所有 AI 叶片诊断都在设备本地运行,因此扫描的照片从不会上传到云端;在未经你明确开启的情况下,位置数据也绝不会被公开分享。
这个项目真的是开源的吗?尽管 GitHub 的主题标签里标注了 'mit-license',但 README 本身写明该项目为专有且保密的,保留所有权利,因此其实际授权条款并不清楚。
什么是花园健康评分?它是一项综合指标,追踪 8 项信号,包括土壤湿度、光照强度、pH 稳定性、生长速度等,并将这些数据转化为通俗易懂的分析,告诉你植物的生长状况。
它如何适应不同的种植方式?首次使用引导会询问“你是怎么种植的?”(土培、容器、水培或室内),随后应用会根据你选择的方式调整整个界面、养护日程和 AI 指导,而不是使用通用模板。
没有网络连接也能使用吗?可以。它采用离线优先的缓存架构,因此核心的记录和养护功能在无网络时仍可使用;但实时天气和云同步仍需要网络连接。
它包含哪些社交功能?用户可以加入基于位置的“花园集群”交流心得,获得如“水培大师”之类的连续成长徽章,还能自动生成可分享的前后对比延时短视频,用于 Instagram 或 TikTok。
大小
52.8 MB
星标
2.8K
更新
提交Jun 30
时长
5个月
提交 · 90 天