open-index/open-npm huggingface dataset:
npm package: @herdingbits/create-trailhead
Description: Create a new Trailhead application shell
Author: HerdingBits
Latest version: 0.0.4

# @herdingbits/create-trailhead

Scaffold a new Trailhead application shell with a single command.

## Usage

```bash
npx @herdingbits/create-trailhead my-app
```

## Options

```
npx @herdingbits/create-trailhead <project-name> [options]

Options:
  --design-system <name>   Design system to use (shoelace|cloudscape)
  --no-demo               Skip creating demo app
  --help, -h              Show help message
```

## Examples

### Create with Shoelace (default)
```bash
npx @herdingbits/create-trailhead my-app
```

### Create with CloudScape
```bash
npx @herdingbits/create-trailhead my-app --design-system cloudscape
```

### Create without demo app
```bash
npx @herdingbits/create-trailhead my-app --no-demo
```

## What Gets Created

```
my-app/
├── shell/                  # Application shell
│   ├── src/
│   ├── public/
│   │   └── navigation.json
│   ├── index.html
│   ├── vite.config.js
│   └── package.json
├── apps/
│   └── demo/              # Demo SPA (if --no-demo not specified)
│       ├── src/
│       ├── index.html
│       ├── vite.config.js
│       └── package.json
├── deploy.js              # Deployment assembly script
├── package.json
└── README.md
```

## Next Steps

After creating your project:

```bash
# Install and start shell
cd my-app/shell
npm install
npm start  # Port 3001

# In another terminal, install and start demo app
cd my-app/apps/demo
npm install
npm start  # Port 3000

# Visit http://localhost:3001
```

## Adding New Apps

Copy the demo app structure:

```bash
cd my-app
cp -r apps/demo apps/users
```

Update `shell/public/navigation.json`:

```json
{
  "id": "users",
  "path": "/users",
  "app": "users",
  "icon": "people",
  "label": "Users",
  "order": 2
}
```

## Documentation

- [Trailhead Documentation](https://github.com/quicken/trailhead)
- [Getting Started Guide](https://github.com/quicken/trailhead/blob/main/docs/GETTING_STARTED.md)

## License

MIT
npm package: @herdingbits/trailhead-cloudscape
Description: AWS CloudScape adapter for Trailhead. React-based shell with CloudScape components. Supports React 19.
Author: HerdingBits
Latest version: 0.0.10

# @herdingbits/trailhead-cloudscape

AWS CloudScape adapter for Trailhead. React-based shell with CloudScape components.

## What is this?

This package provides a Trailhead adapter for the [AWS CloudScape Design System](https://cloudscape.design/). CloudScape is built with React, so this adapter demonstrates Trailhead when you're all-in on React for both the shell and SPAs.

It includes:
- CloudScape React components integration
- Pre-built shell UI (AppLayout, SideNavigation, Modal, Flashbar)
- Event-based communication between adapter and React components
- **Supports React 18 and React 19**

## Key Features

- **React-Based**: Full CloudScape component library
- **AWS Design Language**: Consistent with AWS console UX
- **Pre-Built Shell**: AppLayout with navigation out of the box
- **Modern React**: Works with React 18+ and React 19

## Installation

```bash
npm install @herdingbits/trailhead-core @herdingbits/trailhead-cloudscape @cloudscape-design/components @cloudscape-design/global-styles react react-dom
```

## Usage

```typescript
import React from 'react';
import { createRoot } from 'react-dom/client';
import { Trailhead } from '@herdingbits/trailhead-core';
import { CloudScapeAdapter, ShellApp } from '@herdingbits/trailhead-cloudscape';
import '@cloudscape-design/global-styles/index.css';
import '@herdingbits/trailhead-cloudscape/shell.css';

const shell = new Trailhead({
  adapter: new CloudScapeAdapter(),
  basePath: '/app',
  apiUrl: 'https://api.example.com'
});

const root = createRoot(document.getElementById('app')!);
root.render(<ShellApp shell={shell} />);
```

## What's Included

- **CloudScapeAdapter** - Implements the Trailhead adapter interface
- **ShellApp** - React component that renders the shell UI
- **ShellLayout** - CloudScape AppLayout with navigation
- **shell.css** - Base styles for the shell UI

## React Version Support

This adapter supports React 18 and React 19. Peer dependencies specify `^19.0.0` but will work with React 18 if needed.

## Documentation

See the [main Trailhead documentation](https://github.com/quicken/trailhead) for more information.

## License

MIT
npm package: @herdingbits/trailhead-core
Description: Simple application shell that orchestrates multiple SPAs. No webpack magic, just the browser's native module system.
Author: HerdingBits
Latest version: 0.0.12

# @herdingbits/trailhead-core

Simple application shell that orchestrates multiple SPAs. No webpack magic, just the browser's native module system.

## What is this?

This package provides the core shell logic for the Trailhead micro-frontend pattern:
- Orchestrates multiple single page applications (SPAs) within a shared layout
- Manages navigation and routing (no URL rewrites needed between apps)
- Provides centralized HTTP client with error handling
- Coordinates user feedback (toasts, dialogs, busy states)
- Integrates with design systems via adapters

**Think of it like browser extensions or VS Code plugins** - the shell provides infrastructure, SPAs focus on business logic.

## Key Features

- **Framework Agnostic**: SPAs can use React, Vue, Svelte, or vanilla JS
- **Independent Deployment**: Deploy one SPA without touching others
- **Simple Deployment**: No URL rewrites, works on any static host
- **Design System Adapters**: Pluggable UI layer (Shoelace, CloudScape, or custom)

## Installation

```bash
npm install @herdingbits/trailhead-core
```

## Usage

```typescript
import { Trailhead } from '@herdingbits/trailhead-core';
import { YourAdapter } from '@herdingbits/trailhead-your-design-system';

const shell = new Trailhead({
  adapter: new YourAdapter(),
  basePath: '/app',
  apiUrl: 'https://api.example.com'
});
```

## Available Adapters

- **[@herdingbits/trailhead-shoelace](https://www.npmjs.com/package/@herdingbits/trailhead-shoelace)** - Shoelace web components (vanilla TypeScript)
- **[@herdingbits/trailhead-cloudscape](https://www.npmjs.com/package/@herdingbits/trailhead-cloudscape)** - AWS CloudScape Design System (React)

## Documentation

See the [main Trailhead documentation](https://github.com/quicken/trailhead) for more information.

## License

MIT
npm package: @herdingbits/trailhead-shoelace
Description: Shoelace web components adapter for Trailhead. Vanilla TypeScript, no React required.
Author: HerdingBits
Latest version: 0.0.12

# @herdingbits/trailhead-shoelace

Shoelace web components adapter for Trailhead. Vanilla TypeScript, no React required.

## What is this?

This package provides a Trailhead adapter for the [Shoelace](https://shoelace.style/) web component library. It handles:
- Loading and configuring Shoelace components
- Rendering toasts, dialogs, and busy overlays
- Integrating Shoelace with the Trailhead shell
- **Vanilla TypeScript implementation** - no framework required

**Perfect for teams that want to stay close to HTML/CSS/JavaScript** without React complexity.

## Key Features

- **Framework Agnostic**: Works with any SPA framework (or no framework)
- **Web Components**: Shoelace components work everywhere
- **Lightweight**: No React, no virtual DOM, just the browser
- **Simple**: Straightforward DOM manipulation and event handling

## Installation

```bash
npm install @herdingbits/trailhead-core @herdingbits/trailhead-shoelace @shoelace-style/shoelace
```

## Usage

```typescript
import { Trailhead } from '@herdingbits/trailhead-core';
import { ShoelaceAdapter, ShellApp } from '@herdingbits/trailhead-shoelace';
import '@herdingbits/trailhead-shoelace/shell.css';

const shell = new Trailhead({
  adapter: new ShoelaceAdapter(),
  basePath: '/app',
  apiUrl: 'https://api.example.com'
});

ShellApp.mount(shell);
```

## What's Included

- **ShoelaceAdapter** - Implements the Trailhead adapter interface
- **ShellApp** - Minimal mounting wrapper for API consistency
- **shell.css** - Base styles for the shell UI

## Documentation

See the [main Trailhead documentation](https://github.com/quicken/trailhead) for more information.

## License

MIT
npm package: @herdingbits/trailhead-types
Description: TypeScript types for Trailhead SPAs. Provides shell API types for independent applications.
Author: HerdingBits
Latest version: 0.0.10

# @herdingbits/trailhead-types

TypeScript types for Trailhead SPAs. Provides shell API types for independent applications.

**Note:** This package is auto-generated from `@herdingbits/trailhead-core` during build. Do not edit these files directly.

## What is this?

Provides TypeScript types for single page applications (SPAs) that integrate with the Trailhead shell. Install this as a dev dependency to get type checking and IntelliSense for the shell API.

**Your SPAs don't import the shell** - they access it via `window.shell`. These types just help TypeScript understand what's available.

## Installation

```bash
npm install --save-dev @herdingbits/trailhead-types
```

## Usage

### In Single Page Applications (SPAs)

```typescript
import type { ShellAPI } from '@herdingbits/trailhead-types';

// Declare global type
declare global {
  interface Window {
    shell: ShellAPI;
  }
}

export function init() {
  // TypeScript knows the shell API
  window.shell.feedback.success('App loaded!');
  
  const result = await window.shell.http.get('/api/data');
  if (result.success) {
    console.log(result.data);
  }
}
```

### For Custom Adapter Development

```typescript
import type { DesignSystemAdapter, FeedbackAdapter } from '@herdingbits/trailhead-types/adapters';

export class MyAdapter implements DesignSystemAdapter {
  name = 'my-adapter';
  version = '1.0.0';
  
  async init(basePath: string): Promise<void> {
    // Initialize your design system
  }
  
  feedback: FeedbackAdapter = {
    // Implement feedback methods
  };
}
```

## Documentation

See the [main Trailhead documentation](https://github.com/quicken/trailhead) for more information.

## License

MIT
npm package: @herdora-cli/herdora
Description: A CLI chatbox for GPU-kernel development
Latest version: 0.1.3

<div align="center">
  <img src="https://raw.githubusercontent.com/technoabsurdist/cow/main/herd.png" alt="Herdora" width="400"/>
</div>

<div align="center">
<h4>Herdora CLI</h4>

_coding agent for GPU-kernel development_

Built by [Herdora](https://herdora.com/)

</div>

---

### Quick install

```bash
npm install -g herdora
export OPENAI_API_KEY=sk-…
```

---

### Launch

```bash
cd /your/project
herdora
```

A framed chat prompt appears:

```
┌─ Herdora ─────────────────────────────────────────────-┐
│ You’re chatting with herdora                           │
│ Type !help for commands; Ctrl-C twice to exit          │
└────────────────────────────────────────────────────────┘
herdora ›
```

You're ready to optimize your GPUs!

---

### Example session

```
herdora › read kernels/matmul.cu
(🥷 Herdora streams the file with syntax highlighting)

herdora › optimise this kernel for H100, target 128x128 tiles
(⚙️  Herdora shows a diff — you confirm Y/n)

herdora › what speed-up should I expect vs PyTorch matmul on 4096×4096?
(💡 Explanation + back-of-envelope FLOP math)

herdora › create tests/matmul_benchmark.py to time both versions
(✏️  New file drafted, pending confirmation)
```

All operations—read, write, diff—are driven by free-form chat; no separate sub-commands.

---

---

### Development

To develop and test the CLI locally:

1. Clone the repository

   ```bash
   git clone https://github.com/yourusername/herdora-cli.git
   cd herdora-cli
   ```

2. Install dependencies

   ```bash
   npm install
   ```

3. Build the TypeScript code

   ```bash
   npm run build
   ```

4. Run in development mode

   ```bash
   npm run dev
   ```

5. Link the package locally
   ```bash
   sudo npm link
   ```

Now you can use the `herdora` command from anywhere on your system.