Warning
Deprecated (Legacy Stack A Reference Implementation)
This repository contains the legacy Stack A (v1.0) Progressive Web App implemented in React 19 and Vite with pnpm. It has been deprecated and superseded in production by the canonical modern Stack B PWA: SmartPot-Web (SolidJS 1.9 + Bun + Vite, with live SSE, deep dark mode, HttpOnly cookies, and reactive i18n). Preserved solely for historical reference.
SmartPot-Web-React is the original user interface of SmartPot: a Progressive Web App (PWA) built with React 19, Vite, Tailwind CSS, and Lucide Icons that allowed growers to monitor hydroponic crops in real time, control actuators, simulate virtual crops, and review AI insights.
React 19 · TypeScript 6 · Vite 8 · Tailwind CSS 4 · React Router 7 · Recharts · Lucide · Vitest · Testing Library · pnpm 11.
SmartPot-Web/
├── public/
│ ├── icons/ # Íconos SVG fuente y PNG de la PWA
│ ├── manifest.webmanifest # Instalación como app
│ ├── sw.js # Service worker: app shell en caché, API siempre en red
│ ├── robots.txt, sitemap.xml # SEO
│ ├── og-image.svg / .png # Imagen para redes sociales
│ └── config.js # URL de la API en desarrollo (el contenedor lo reescribe)
├── src/
│ ├── app/ # Enrutador y páginas generales
│ ├── components/ # Marca, layouts y componentes de interfaz
│ ├── config/env.ts # URL de la API en tiempo de ejecución
│ ├── features/
│ │ ├── auth/ # Sesión, ingreso, registro y recuperación
│ │ ├── overview/ # Panel general: ranking, comparativas y análisis de la IA
│ │ ├── control/ # Control general: modo automático y órdenes en bloque
│ │ ├── actions/ # Acciones sugeridas e historial de todos los cultivos
│ │ ├── crops/ # Creación real o virtual, ilustración, resumen, asistente, control, historial, dispositivo, simulación y ajustes
│ │ ├── learning/ # Aprendizaje de la IA: calidad, comparación de modelos, estados y atípicos
│ │ ├── landing/ # Página pública y preguntas frecuentes
│ │ ├── notifications/ # Alertas
│ │ ├── profile/ # Perfil, canales de notificación (Telegram), contraseña y borrado de cuenta
│ │ └── pwa/ # Registro del service worker e instalación
│ ├── hooks/ # Metadatos por página, recursos con refresco y conexión
│ ├── lib/ # Cliente de la API, tipos, catálogos y formato en español
│ └── styles/index.css # Paleta SmartPot como tokens de Tailwind
├── nginx/ # Servidor de la imagen: CSP, caché y configuración en tiempo de ejecución
├── scripts/generate-icons.mjs # PNG de la PWA a partir de los SVG
└── Dockerfile
| Token | Color | Uso |
|---|---|---|
leaf-900 |
#0B3D2B |
Barra lateral, navegación, encabezados y color del tema de la PWA |
leaf-700 |
#067A52 |
Acciones principales |
leaf-500 |
#00B074 |
Verde de marca |
water-500 |
#2D9CDB |
Agua, información y señal del logo |
sun-500 |
#F2B632 |
Luz y advertencias |
clay-500 |
#D9734E |
Maceta de la ilustración y temperatura |
danger-500 |
#D64545 |
Errores |
ink / muted / line / surface |
#17261F / #5B6B63 / #D5E3DC / #F2F7F4 |
Texto, bordes y superficies |
Tipografías: Outfit para títulos e Inter para el cuerpo, servidas desde la propia app (sin CDNs).
Las comparativas entre cultivos usan una paleta categórica de 8 colores en orden fijo (tonos de la marca más un violeta solo para gráficos), validada para daltonismo y contraste entre vecinos. Cada cultivo conserva su color mientras siga en la comparación, y los gráficos van acompañados de leyenda y de la tabla de últimas lecturas.
index.htmltrae descripción, palabras clave, URL canónica, Open Graph, Twitter Card y datos estructurados JSON-LD (Organization,WebSite,SoftwareApplicationyFAQPage), además de contenido estático que leen los rastreadores sin JavaScript.- Cada página ajusta su título y
robots: la landing, el ingreso y el registro se indexan;/appno. - El manifiesto declara íconos normales y adaptables, accesos directos y el color
#0B3D2B. El botón «Instalar app» aparece cuando el navegador lo permite; en iPhone se explica «Compartir → Agregar a inicio». - El service worker guarda el app shell y los recursos con hash; la API y
/config.jsnunca se guardan en caché.
- CSP estricta (
script-src 'self',style-src 'self',connect-srclimitado a la API),X-Frame-Options: DENY,nosniff,Referrer-PolicyyPermissions-Policy(solo la geolocalización del propio sitio, para ubicar un cultivo virtual en modo clima; nunca se envía sin que la persona toque «Usar mi ubicación»). - El token JWT se guarda en
localStoragesolo si el usuario marca «Mantener sesión iniciada»; si no, ensessionStorage. Un 401 cierra la sesión. - La clave del dispositivo se muestra una sola vez, al crear un cultivo real o al rotarla.
La imagen es pública: ghcr.io/smartpottech/smartpot-web. La plataforma completa, con este servicio incluido, se
levanta con un solo comando y sin descargar el código:
curl -fsSL https://raw.githubusercontent.com/SmartPotTech/.github/main/docker/demo/compose.yaml | docker compose -f - up -d --waitAbre http://localhost:5173 e ingresa con demo@smartpot.app / SmartPot2026. Se detiene con
docker compose -p smartpot-demo down (con -v borra también los datos). Más detalle en la
demo.
Solo este servicio, con la imagen publicada:
docker run -d --name smartpot-web -p 5173:8080 -e API_URL=http://localhost:8091 \
--read-only --tmpfs /tmp --tmpfs /etc/nginx/conf.d:uid=101,gid=101 \
ghcr.io/smartpottech/smartpot-web:latest- Node.js 22 o 24 y pnpm 11 (
corepack enable) - La API de SmartPot en
http://localhost:8091(el entorno completo está en SmartPotTech/.github)
pnpm install
pnpm devpnpm lint
pnpm typecheck
pnpm test
pnpm buildLas pruebas cubren el cliente HTTP y sus errores en español, la sesión, las validaciones, el ingreso, los componentes del cultivo, el panel del asistente, lo aprendido y la comparación de modelos, los canales de Telegram, la ilustración del cultivo (formas, especies, actuadores, clima y conexión), la creación real o virtual, la guía de conexión y los requisitos de SEO y PWA.
docker build -t smartpot-web .
docker run --rm -p 5173:8080 -e API_URL=http://localhost:8091 \
--read-only --tmpfs /tmp --tmpfs /etc/nginx/conf.d:uid=101,gid=101 smartpot-webAPI_URL se inyecta al arrancar en /config.js y en la CSP, así la misma imagen sirve para cualquier entorno. Imagen
publicada: ghcr.io/smartpottech/smartpot-web:latest.
Cada cambio en main pasa por el CI, publica la imagen en GHCR (y en Docker Hub como réplica cuando el repositorio
tiene credenciales) y pide el despliegue al workflow central
de SmartPotTech/.github, que actualiza producción de a uno y verifica
/health.
Tras cambiar los SVG de public/icons o public/og-image.svg:
pnpm iconsLa PWA es la cara de la plataforma: todo lo que muestra viene de la API. Su documentación propia está en
docs/ (también en DOCX
y PDF), con sus diagramas en docs/diagrams: el general del
componente y los de creación de un cultivo, su ilustración y sesión y caché.
La documentación técnica
describe cada pantalla, la identidad visual, el SEO y la seguridad web. Los diagramas generales muestran la plataforma
completa en una sola imagen ampliable:
- Recorrido de la PWA: cada pantalla, las rutas de la API que llama y el servicio que responde
- Operación completa: qué pasa detrás de cada acción de la persona, de la PWA al dispositivo
- Arquitectura completa: dónde vive la PWA dentro de la plataforma
Este proyecto está bajo la licencia MIT. Consulta el archivo LICENSE para más detalles.