Neumann's Workshop

A modern professional portfolio and services website showcasing AI/ML engineering expertise, open-source projects, and consulting services. Built with React + Vite and deployed as a static site to GitHub Pages.

🏗️ Architecture

This site is built with Vite 5, React 18, and TypeScript, featuring:

• Single Page Application (SPA) with client-side routing
• TypeScript for type safety and better development experience
• Modern Professional Design with clean, accessible UI
• Mobile-First Responsive Design with comprehensive breakpoints
• Tailwind CSS for utility-first styling with custom configuration
• Optimized Build Process with Vite's lightning-fast HMR

🚀 Quick Start

Prerequisites

• Node.js 18+
• npm or yarn

Development

# Install dependencies
npm install

# Start development server with hot reload
npm run dev

# Open http://localhost:5173

Building & Deployment

# Build for production
npm run build

# Preview production build locally
npm run preview

# Files will be in ./dist/ directory

📁 Project Structure

src/
├── components/
│   ├── Header.tsx          # Navigation and site header
│   └── Footer.tsx          # Site footer with social links
├── pages/
│   ├── HomePage.tsx        # Landing page
│   ├── AboutPage.tsx       # Professional bio and experience
│   ├── ServicesPage.tsx    # Consulting services offered
│   ├── PortfolioPage.tsx   # Project showcase with tech stacks
│   └── ContactPage.tsx     # Contact information
├── styles/
│   └── index.css          # Global styles and Tailwind imports
├── App.tsx                # Main app component with routing
└── main.tsx              # Application entry point

public/
├── assets/               # Images, logos, and static files
│   ├── images/          # Project screenshots and visuals
│   ├── *.svg           # Icons and vector graphics
│   └── *.png           # Raster images
├── resume.md           # Markdown resume source
└── Neumann_Resume_ML_2025.pdf  # PDF resume

Root Configuration:
├── index.html           # HTML entry point
├── vite.config.ts      # Vite configuration
├── tailwind.config.js  # Tailwind CSS configuration
├── tsconfig.json       # TypeScript configuration
└── package.json        # Dependencies and scripts

📄 Pages

Home Page

Professional landing page with hero section and overview of expertise areas.

About Page

• Professional background and biography
• Detailed experience timeline with three positions:
  • Freelance ML Consultant (Nov 2023 - Present)
  • Machine Learning Engineer at Interos, Inc. (Jan 2022 - Nov 2023)
  • Data Scientist at American Express (May 2019 - Dec 2021)
• Education and skills summary

Portfolio Page

Comprehensive project showcase organized into three sections:

1. Featured Projects: Open-source tools and experimental systems

   • ExplainerKit (XAI framework)
   • AHAB (semantic alignment evaluation)
   • Synapse (word puzzle game)
   • Šā'ilu (semantic oracle)
   • Cleros (semantic search for ancient texts)

2. Research Projects: Academic and experimental work

   • PhonoLex (phonological embeddings)
   • Norm-Constrained Embeddings (cognitive knowledge graphs)

3. Client Work: Production ML systems

   • Hospital credentialing automation
   • Healthcare document intelligence

Services Page

Detailed overview of consulting services:

• Natural Language Processing (NLP)
• AI Explainability & Compliance (XAI)
• Document Intelligence & Automation
• MLOps & Production Systems

Contact Page

Contact information and social media links.

🎨 Design System

Professional Modern Aesthetic

• Color Palette: Blue accent (#2563eb) with gray scale
• Typography: System fonts with proper hierarchy
• Interactions: Smooth transitions and hover effects
• Mobile: Touch-friendly with responsive breakpoints

Key Features

• Clean, accessible navigation
• Responsive grid layouts
• Professional project cards
• Optimized for fast loading

🔧 Technical Stack

Core Technologies

• React 18: Modern React with hooks
• TypeScript 5: Full type safety
• Vite 5: Fast build tooling and HMR
• Tailwind CSS 3: Utility-first styling

Build & Deploy

• Static Export: Pre-rendered HTML for all routes
• GitHub Pages: Automated deployment
• Optimized Assets: Image optimization and code splitting

🚢 Deployment

The site automatically deploys to GitHub Pages via GitHub Actions when changes are pushed to the main branch.

Workflow:

1. Push to main branch
2. GitHub Actions runs npm run build
3. Static files deployed to gh-pages branch
4. Site live at https://neumannsworkshop.com (custom domain via CNAME)

📊 Content Management

Updating Portfolio Projects

Edit /src/pages/PortfolioPage.tsx to update project descriptions, tech stacks, and links.

Updating Experience

Edit /src/pages/AboutPage.tsx to update professional experience and biography.

Updating Services

Edit /src/pages/ServicesPage.tsx to update service offerings and descriptions.

🤝 Contributing

1. Fork the repository
2. Create a feature branch
3. Make your changes following the existing patterns
4. Test locally with npm run dev
5. Submit a pull request

📄 License

© 2025 Neumann's Workshop, LLC. All rights reserved.

📧 Contact

• Email: jared@neumannsworkshop.com
• LinkedIn: Jared Neumann
• GitHub: neumanns-workshop

📦 Archive

Previous versions of the site (Next.js App Router, vanilla HTML/CSS/JS) are preserved in the archive/ directory for reference.