open-index/open-npm huggingface dataset:
npm package: @minecraft-docker/mcctl-console
Description: Web management console for Docker Minecraft servers
Author: smallmiro
Latest version: 2.20.2

# mcctl-console

Web-based management console for Minecraft server infrastructure.

## Tech Stack

- **Framework**: Next.js 14 (App Router)
- **Language**: TypeScript 5.x
- **UI Library**: MUI (Material-UI) 5.x
- **Styling**: Tailwind CSS 3.x
- **State Management**: React Query (TanStack) 5.x
- **Testing**: Vitest + React Testing Library + Playwright

## Getting Started

```bash
# Install dependencies
pnpm install

# Start development server
pnpm dev

# Build for production
pnpm build

# Start production server
pnpm start
```

## Scripts

| Script | Description |
|--------|-------------|
| `pnpm dev` | Start development server on port 5000 |
| `pnpm build` | Build for production |
| `pnpm start` | Start production server |
| `pnpm lint` | Run ESLint |
| `pnpm type-check` | Run TypeScript type checking |
| `pnpm test` | Run unit tests |
| `pnpm test:e2e` | Run E2E tests with Playwright |

## Architecture

This project follows **Hexagonal Architecture (Ports & Adapters)** pattern.

```
src/
├── app/              # Next.js App Router (Pages)
├── components/       # React UI Components
├── hooks/            # Custom React Hooks
├── services/         # Application Layer (Use Cases)
├── ports/            # Application Layer (Interfaces)
├── adapters/         # Infrastructure Layer (Implementations)
├── lib/              # Utilities and Providers
├── theme/            # MUI Theme Configuration
└── types/            # TypeScript Type Definitions
```

## Environment Variables

| Variable | Description | Default |
|----------|-------------|---------|
| `MCCTL_API_URL` | mcctl-api internal URL | `http://localhost:5001` |
| `MCCTL_API_KEY` | API Key for authentication | (required) |
| `NEXT_PUBLIC_APP_URL` | App base URL | `http://localhost:5000` |

## Documentation

See [prd.md](./prd.md) for detailed product requirements and [plan.md](./plan.md) for implementation plan.
npm package: @minecraft-docker/shared
Description: Shared utilities and types for Minecraft Docker platform
Author: smallmiro
Latest version: 2.20.2

# @minecraft-docker/shared

Shared utilities and types for the Minecraft Docker platform.

## Installation

```bash
npm install @minecraft-docker/shared
```

## Usage

This package provides shared components for the [@minecraft-docker/mcctl](https://www.npmjs.com/package/@minecraft-docker/mcctl) CLI tool.

### Domain Layer

```typescript
import { ServerName, ServerType, McVersion, Memory } from '@minecraft-docker/shared/domain';

const name = ServerName.create('myserver');
const type = ServerType.create('PAPER');
const version = McVersion.create('1.21.1');
const memory = Memory.create('4G');
```

### Application Layer

```typescript
import { ICreateServerUseCase, IServerRepository } from '@minecraft-docker/shared/application';
```

### Infrastructure Layer

```typescript
import { ShellAdapter, ServerRepository } from '@minecraft-docker/shared/infrastructure';
```

## Architecture

This package follows **Hexagonal Architecture** (Clean Architecture):

```
┌─────────────────────────────────────┐
│  Application Layer                   │
│  - Use Cases (ports/inbound)         │
│  - Ports (ports/outbound)            │
└──────────────────┬──────────────────┘
                   │
┌──────────────────▼──────────────────┐
│  Domain Layer                        │
│  - Entities (Server, World)          │
│  - Value Objects (ServerName, etc.)  │
└──────────────────┬──────────────────┘
                   │
┌──────────────────▼──────────────────┐
│  Infrastructure Layer                │
│  - Adapters (Shell, Repository)      │
└─────────────────────────────────────┘
```

## Documentation

- [Full Documentation](https://minecraft-server-manager.readthedocs.io/)
- [GitHub Repository](https://github.com/smallmiro/minecraft-server-manager)

## License

Apache-2.0