A modern web management console for RustFS distributed file system.

• Vue 3 + Nuxt 4 + TypeScript + Tailwind CSS v4
• shadcn-vue components with dark mode
• i18n support (English, Chinese, Turkish)
• Responsive design
• S3-compatible API with AWS signing
• Real-time monitoring dashboard

• Node.js >= 22.0.0
• pnpm >= 10.27.0 (managed via corepack or mise)
• RustFS backend running

git clone https://github.com/rustfs/console.git
cd console
pnpm install

pnpm dev

Server starts at http://localhost:3000.

Create .env:

APP_NAME=RustFS
BASE_URL=/rustfs/console/
API_BASE_URL=http://localhost:9000/rustfs/admin/v3
SERVER_HOST=http://localhost:9000
S3_REGION=us-east-1
S3_ENDPOINT=http://localhost:9000

Configuration is auto-detected from server config, localStorage, or browser host.

pnpm build
pnpm preview

├── components/ # Vue components
├── composables/ # Reusable logic
├── pages/ # Nuxt routes
├── lib/ # API clients, utilities
├── store/ # Pinia stores
├── tests/ # Test files
└── utils/ # Utility functions

pnpm type-check # TypeScript checking
pnpm lint # Linting
pnpm lint:fix # Auto-fix formatting

pnpm test # Run tests
pnpm test:run # CI mode
pnpm test:coverage # With coverage

See tests/README.md for details.

• Component files: kebab-case (bucket-selector.vue)
• Component usage: StudlyCase (<BucketSelector />)
• Composables: camelCase with use prefix (useBucket.ts)
• TypeScript: Strict mode, avoid any
• Comments: English only

1. Fork and clone
2. Create feature branch: git checkout -b feature/amazing-feature
3. Make changes following coding standards
4. Test: pnpm type-check && pnpm lint && pnpm test:run
5. Commit: git commit -m 'feat: add amazing feature' (English only)
6. Push and create PR

Before committing, run all checks:

# Quick check (lint, type-check, tests, build)
pnpm run check
# Full check (includes security audit)
pnpm run pre-commit

Or manually:

• ✅ pnpm lint passes
• ✅ pnpm type-check passes
• ✅ pnpm test:run passes
• ✅ pnpm build succeeds
• ✅ pnpm audit --audit-level=moderate passes
• ✅ No debug code (console.log)
• ✅ Self-reviewed
• ✅ Commit messages in English

Tip: Run pnpm run check before every commit to catch issues early.

Follow Conventional Commits:

• feat: New features
• fix: Bug fixes
• docs: Documentation
• style: Formatting
• refactor: Code refactoring
• test: Tests
• chore: Build/tool changes

All commit messages must be in English.

pnpm build

Output: .output/public (static files)

FROM node:22-alpine AS builder
WORKDIR /app
COPY package.json pnpm-lock.yaml ./
RUN corepack enable && corepack prepare pnpm@10.27.0 --activate
RUN pnpm install --frozen-lockfile
COPY . .
RUN pnpm build
FROM nginx:alpine
COPY --from=builder /app/.output/public /usr/share/nginx/html
EXPOSE 80

Apache License 2.0 - see LICENSE