Skip to content
bostonjoPublic

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

Teaching Tools Dashboard

A modern, interactive dashboard for managing and accessing educational technology tools. Built for Professor Duane J. Lefevre at Northeastern University's D'Amore-McKim School of Business.

Overview

The Teaching Tools Dashboard provides a centralized, visual interface for organizing and accessing educational tools, simulations, and resources. It features an intuitive card-based layout with categories, built-in admin mode for easy management, and intelligent URL tracking.

Key Features

User Features

  • Organized Categories: Tools grouped into logical categories (Simulation Tools, Debate Tools, Spreadsheet Processors, etc.)
  • Visual Interface: Color-coded categories with icons for quick identification
  • One-Click Access: Click any tool to open in a new browser tab
  • URL Type Indicators: Visual badges showing whether links are chat-based (stable) or artifact-based (version-specific)
  • Stale Link Warnings: Clear indicators when tools need updating
  • Responsive Design: Works seamlessly on desktop and tablet devices

Admin Features

  • Edit Mode: Toggle admin mode to manage all content
  • Category Management: Add, edit, or delete entire categories
  • Tool Management: Add, edit, or delete individual tools
  • Stale Link Tracking: Mark tools as stale when URLs become outdated
  • Bulk Link Testing: Test all URLs at once
  • Undo Functionality: Restore accidentally deleted items (Ctrl+Z)
  • Keyboard Shortcuts: Quick access to common actions
  • Real-time Saving: Automatic persistence of all changes

Two Available Versions

1. Claude Artifact Version (.tsx)

File: teaching-tools-dashboard.tsx

  • Use Case: Designed to run as a Claude Artifact within Claude.ai
  • Storage: Uses window.storage API (Claude's persistent storage)
  • Deployment: Copy code into Claude, request artifact rendering
  • Best For: Quick prototyping, testing, or temporary use within Claude sessions

How to Use:

  1. Open a conversation with Claude at claude.ai
  2. Share the .tsx file contents
  3. Ask Claude to render it as an artifact
  4. Access directly from your Claude conversation

2. Standalone HTML Version (.html)

File: teaching-tools-dashboard.html

  • Use Case: Self-contained web application
  • Storage: Uses browser localStorage for persistence
  • Deployment: Open directly in any modern web browser
  • Best For: Production use, bookmarking, or sharing with others

How to Use:

  1. Download the .html file to your computer
  2. Double-click to open in your default browser
  3. Bookmark the file location for easy access
  4. Data persists across browser sessions

Quick Start

For End Users

  1. Open the dashboard (artifact or HTML file)
  2. Browse available tool categories
  3. Click any tool card to open the tool in a new tab
  4. Look for badges:
    • Green "chat": Stable URL (recommended)
    • Yellow "artifact": Version-specific URL
    • Orange "Stale": URL needs updating

For Administrators

  1. Click the "Admin Mode" button in the top right
  2. Use the interface to:
    • Add new categories or tools
    • Edit existing items
    • Delete outdated content
    • Mark stale links
    • Test all URLs
  3. Click "Exit Admin" when finished

Technology Stack

Frontend Framework

  • React 18: Component-based UI architecture
  • React Hooks: State management (useState, useEffect, useRef)

Styling

  • Tailwind CSS: Utility-first CSS framework
  • Custom Animations: Smooth transitions and loading states

Icons

  • Lucide React: Modern, consistent icon set

Storage

  • TSX Version: window.storage API (Claude Artifacts)
  • HTML Version: localStorage API (browser storage)

Build System

  • TSX Version: Designed for Claude's JSX/TSX runtime
  • HTML Version: Uses Babel Standalone for in-browser JSX compilation

File Structure

Dashboard/
├── teaching-tools-dashboard.tsx    # Claude Artifact version
├── teaching-tools-dashboard.html   # Standalone web version
├── README.md                       # This file
├── USER_GUIDE.md                   # End-user documentation
├── ADMIN_GUIDE.md                  # Administrator documentation
└── TECHNICAL_DOCS.md               # Technical/developer documentation

Data Persistence

Both versions automatically save all changes:

  • Categories: Name, icon, color, and order
  • Tools: Name, description, URL, and stale status
  • State: Persists across page refreshes

Storage Keys:

  • teaching-tools-config: JSON string containing all dashboard data

Default Categories

The dashboard comes pre-configured with:

  1. Simulation Tools (Blue) - Interactive business simulations
  2. Debate Tools (Purple) - Debate management and assessment
  3. Spreadsheet Processors (Green) - Data processing utilities
  4. Other Tools (Orange) - Additional educational resources

Browser Compatibility

Supported Browsers

  • Google Chrome (recommended)
  • Microsoft Edge
  • Mozilla Firefox
  • Safari

Requirements

  • Modern browser with ES6+ support
  • JavaScript enabled
  • localStorage access (for HTML version)
  • Internet connection (for CDN resources)

URL Types Explained

Chat URLs (Recommended)

  • Format: https://claude.ai/chat/{chat-id}
  • Advantage: Always shows the latest version of the conversation/artifact
  • Stability: High - URL remains valid even if artifact is updated
  • Use Case: Ideal for frequently updated tools

Artifact URLs

  • Format: https://claude.ai/artifacts/{artifact-id}
  • Advantage: Links to a specific version
  • Stability: Medium - URL becomes outdated if artifact is edited
  • Use Case: When version-specific access is required

Security Considerations

  • All tool links open in new tabs with rel="noopener noreferrer"
  • Link testing uses CORS-safe methods
  • No sensitive data stored in localStorage
  • No external API calls or data transmission

Accessibility Features

  • Semantic HTML structure
  • Keyboard navigation support
  • Focus indicators on interactive elements
  • High contrast color schemes
  • Descriptive button labels and titles

Performance

  • Lazy loading animations
  • Optimized re-renders with React
  • Minimal bundle size (CDN dependencies)
  • Fast localStorage operations
  • Smooth transitions (300ms animations)

Support and Customization

For technical details on customizing the dashboard, see:

  • USER_GUIDE.md: End-user instructions
  • ADMIN_GUIDE.md: Administrative functions
  • TECHNICAL_DOCS.md: Code architecture and customization

Version History

Current Version: 1.0

  • Initial release with full admin functionality
  • Dual version support (Artifact and HTML)
  • Undo system for deletions
  • URL type detection and labeling

License

This project is created for educational purposes at Northeastern University.

Contact

Professor Duane J. Lefevre Northeastern University D'Amore-McKim School of Business


Last Updated: 2025-10-26

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages