Skip to content

Repository files navigation

🧊 Iceberg Prompts — Estudio Profundo con IA

Lighthouse Score Accessibility SEO React Vite

Security Intelligence

Iceberg Prompts es una aplicación de estudio de alto rendimiento que aprovecha el Intelligence Core™ de Google Gemini (v2.5) para aplicar metodologías de aprendizaje profundo. Diseñada con una estética Premium Dark y blindada con protocolos de seguridad de vanguardia.


✨ Características Principales

  • 🧠 Metodología Iceberg: 7 acciones críticas para pasar del entendimiento superficial a la maestría.
  • ⚡ Intelligence Core™: Integración optimizada con la serie Gemini 2.5 Flash, garantizando respuestas precisas y latencia mínima.
  • 🛡️ Seguridad de Élite:
    • Supply Chain Protection: Configuración .npmrc estricta para evitar malware en dependencias.
    • Zero Server-Side: Procesamiento 100% en cliente; tu API Key nunca toca un servidor externo.
  • 💎 Estética Premium: Interfaz basada en Glassmorphism, con desenfoques de fondo dinámicos y micro-animaciones suaves.
  • ♿ Accesibilidad 100/100: Cumplimiento total de roles ARIA y estándares WCAG 2.2.
  • 📄 Exportación Profesional: Descarga tus lecciones en formato Markdown (.md) de alta fidelidad.

🛠️ Tecnologías

Core Estilo Calidad
React 19 Vanilla CSS (Glassmorphism) Vitest (Unit Testing)
Vite 6 Google Fonts (Inter, Playfair) Lighthouse Audit (100/100)
Gemini API SVG Icons (Hand-crafted) ESLint & Prettier

🚦 Guía de Inicio Rápido

Requisitos Previos

  • Node.js (v18+)
  • Una API Key de Google AI Studio (Consíguela gratis aquí)

Instalación

  1. Clona el repositorio:
    git clone https://github.com/TU_USUARIO/iceberg_app.git
    cd iceberg_app
  2. Instala las dependencias:
    npm install
  3. Inicia el entorno de desarrollo:
    npm start

⌨️ Comandos de Teclado (Power User)

Domina la aplicación sin despegar las manos del teclado:

  • Ctrl + K: Mostrar/Ocultar el panel de la API Key.
  • Ctrl + Shift + C: Expandir/Colapsar el área de contenido.
  • Ctrl + Enter: Disparar la generación de la IA.
  • Ctrl + ← / →: Navegar entre las pestañas de aprendizaje.

📂 Estructura del Proyecto

src/
├── components/          # Componentes visuales (Header, ActionCard, ResultBlock...)
├── hooks/               # Lógica reutilizable (useGemini, useHistory, useLocalStorage...)
├── data/                # Definición de prompts y lógica de negocio
└── App.jsx              # Orquestador principal y diseño premium
public/
├── robots.txt           # Configuración SEO
└── sitemap.xml          # Mapa del sitio para Google

🏆 Certificación de Calidad

Esta aplicación ha sido auditada rigurosamente para garantizar la mejor experiencia de usuario:

  • SEO: Optimización de meta-datos y estructura semántica para máxima visibilidad.
  • Accesibilidad: Navegación secuencial, etiquetas descriptivas y contraste de color optimizado.
  • Privacidad: Tu API Key nunca sale de tu navegador; se almacena de forma segura y cifrada localmente.

📄 Licencia

Este proyecto está bajo la licencia MIT. Siéntete libre de usarlo, mejorarlo y compartirlo.


Desarrollado con pasión para transformar la forma en que estudiamos. 🧊✨