Lufa Core

A pnpm monorepo housing the shared infrastructure, tooling, and CDN services for the Lufa ecosystem.

---

Overview

Lufa Core is the backbone of the Lufa ecosystem. It provides shared configurations, CDN infrastructure, and experimental POCs used across all Lufa projects.

Repository Structure

Lufa-Core/
├── packages/
│   ├── cdn/                    # CDN infrastructure
│   │   └── autobuild-server/   # On-demand microfrontend build & serving
│   ├── config/                 # Shared tooling configurations
│   │   ├── eslint/             # ESLint shared config
│   │   ├── prettier/           # Prettier shared config
│   │   └── tsconfig/           # TypeScript shared config
│   └── poc/                    # Proof of Concept experiments
├── _docs/                      # Global documentation
├── scripts/                    # Utility scripts
└── images/                     # Project assets

Packages

CDN

Package	Version	Description
@grasdouble/cdn_autobuild-server		Self-fed CDN — builds and serves microfrontend bundles on demand

Config

Package	Version	Description
@grasdouble/lufa_config_eslint		Shared ESLint configurations (basic, node, react)
@grasdouble/lufa_config_prettier		Shared Prettier configuration
@grasdouble/lufa_config_tsconfig		Shared TypeScript configurations (base, node, react-app, react-library)

POC

Experimental implementations — not for production use. See _docs/POCs.md for the full list.

Getting Started

Prerequisites

• Node.js >= 18
• pnpm 11.x

Installation

# Clone the repository
git clone https://github.com/grasdouble/Lufa-Core.git
cd Lufa-Core

# Install dependencies
pnpm install

Development

Common Commands

# Build all packages
pnpm all:build

# Type check all packages
pnpm all:typecheck

# Lint all packages
pnpm all:lint

# Run tests across all packages
pnpm all:test

# Format code (check)
pnpm all:prettier:check

# Format code (write)
pnpm all:prettier:write

Dependency Management

# Check for outdated dependencies
pnpm deps:outdated

# Upgrade all dependencies
pnpm deps:upgrade

# Audit for vulnerabilities
pnpm deps:audit

Cleanup

# Full cleanup (node_modules, dist, cache)
pnpm clean

# Clean only build artifacts
pnpm clean:lib

# Clean only caches
pnpm clean:cache

Versioning & Releases

This project uses Changesets for versioning and publishing.

# Create a new changeset
pnpm changeset

# Version packages
pnpm changeset version

# Publish packages
pnpm changeset publish

Contributing

1. Fork the repository
2. Create a feature branch (git checkout -b feat/my-feature)
3. Commit your changes with a proper message (see commit conventions)
4. Push your branch and open a Pull Request

License

MIT © Grasdouble — see LICENSE.md for details.