📊 Nā Puna ʻIke Dashboard - Data Science Platform

This is the development repository for the Nā Puna ʻIke Dashboard - a comprehensive data science platform. The name "Nā Puna ʻIke" means "the springs of knowledge" in Hawaiian, where "puna" refers to springs that supply water for fishponds and also represents a source of information. The app is developed using React + TypeScript + Vite, with data stored and managed via Firebase (Firestore & Storage).

---

Project Overview

The dashboard allows users to:

• Query, visualize, and analyze weather and environmental data
• Integrate external data sources via API or CSV upload
• Store and manage project-specific information
• Display statistical summaries and generate insights

---

🛠 Tech Stack

• Frontend: React, TypeScript, Vite
• Database & Storage: Firebase (Firestore, Storage)
• Deployment: GitHub Pages
• Styling: MUI (Material UI), custom CSS
• Data Visualization: Recharts, Plotly

---

🚀 Getting Started

🔧 Clone the repository

git clone https://github.com/institute-for-future-intelligence/itest-dashboard.git
cd itest-dashboard

📦 Install Dependencies

npm install

---

🔐 Set Up Firebase Environment

Create a .env file in the root of your project with the following content:

VITE_FIREBASE_API_KEY=...
VITE_FIREBASE_AUTH_DOMAIN=...
VITE_FIREBASE_PROJECT_ID=...
VITE_FIREBASE_STORAGE_BUCKET=...
VITE_FIREBASE_MESSAGING_SENDER_ID=...
VITE_FIREBASE_APP_ID=...
VITE_FIREBASE_MEASUREMENT_ID=...
# Optional: IFI chatbot widget (AuthenticatedLayout). Omit to hide the widget.
VITE_CHATBOT_ID=your-chatbot-id-from-ifi-dashboard

When the chatbot is enabled, each user’s doc at userChatbotState/{uid} may include teach-session IDs, lastConversationId, and a capped conversationIds list (chat metadata only; message text stays with IFI).

Replace the ... with your actual Firebase config values.

---

▶️ Run the Development Server

npm run dev

Then open http://localhost:5173/itest-dashboard/ (the /itest-dashboard/ base path is required; it matches vite.config base and React Router). To see the chatbot locally, add VITE_CHATBOT_ID to .env like in the block above—without it the widget only appears in CI builds that inject the secret.

---

📌 Notes

• This app is still in active development.
• For questions, contributions, or access, contact andriy@intofuture.org.

📚 Documentation

For detailed documentation, please see the docs/ folder:

• New developers: Start with the Getting Started Guide
• Development process: See Development Workflow
• Technical details: Check Architecture Documentation
• Repository setup: Follow Repository Setup Guide