FeltForge 0.4.1

FeltForge 0.4.1 centers table decorations across all six themes in both PokerTable and TableSurface.

• Center the visible suit rows, theme lettering and Royal Burgundy crown.
• Mirror Royal Burgundy studs and center Neon Night/Ocean Slate textures at every supported proportion.
• Center Emerald Club’s top and bottom three-diamond rows between the paired gold lines, including portrait layouts.
• Keep the playground’s portrait player badges clear of the ornaments.

Original materials, shadows, gameplay anchors and public sizing APIs remain unchanged.

Validation: 133 unit/SSR/rendering tests, 32 Chromium/mobile WebKit checks, deterministic asset generation, unchanged-material visual regressions, package checks, and React 18/Next.js tarball consumers.

npm · Playground · Changes

FeltForge 0.4.0

FeltForge 0.4.0 adds TableSurface for applications that position their own players, cards and chips. Configure the outer-rail width and height to render portrait, landscape, circular or intermediate stadium proportions across all six themes.

import { TableSurface } from 'feltforge/table-surface';

<TableSurface
  width={334}
  height={486}
  detailScale={0.57}
  theme="classic"
  decorative
/>

Rails, felt, lighting, stitching, shadows and decorations share the same renderer and material definitions as PokerTable. Existing desktop artwork, public APIs and layout anchors remain compatible.

Table overlays now stack in the order artwork, cards, chips/pots/markers, then seats. The playground includes surface dimension and material controls, and its D/SB/BB markers shrink with the table.

Validation: 124 unit/SSR/rendering tests, 32 browser checks, exact desktop image regressions for all six themes, deterministic asset generation, package checks, and actual packaged React 18 and Next.js consumers.

Integration and sizing guide · Playground · npm

FeltForge 0.3.0

FeltForge 0.3.0 adds five poker table themes alongside the refined Classic design: Midnight Racetrack, Royal Burgundy, Neon Night, Emerald Art Deco and Ocean Slate.

• Choose a design with PokerTable.theme, or build a picker with TABLE_THEMES and TABLE_THEME_LABELS.
• Keep the same 2/6/8/9-seat layouts and interactive HTML overlays across every theme.
• Preserve the Penpot gradients, stitching, studs, patterns, lighting and glow. Decorative lettering and symbols are SVG paths with no added fonts.
• Customize material colors through the existing table tokens, and replace or disable decorative shadows and glow with --table-shadow.
• Explore all six designs in the playground, with an updated README banner and usage documentation.

Validated with 101 unit/rendering tests, 16 browser checks, independent Penpot image comparisons, deterministic generation, package checks and actual tarball React 18/Next.js builds.

Install with npm install feltforge@0.3.0.

Playground · npm · Table API

FeltForge 0.2.2

Aligns the chip rim with the updated Penpot master and adds magnified border previews.

• Make the separate, continuous inner rim explicit above all eight edge inserts, using shared CHIP.rim values: 1px at the 64px design size, black at 28% opacity.
• Apply the same scaled rim to single chips, custom denominations and every visible stack layer, including when shadows are disabled.
• Add 4× close-ups under Chips & markers in the playground and document border sizing and paint order.
• Verify border continuity over every insert across all standard denominations and the custom chip.

The renderer already drew an equivalent rim; this aligns the layer structure without adding a second border. No font files or static chip assets are imported.

Validated with 89 unit/rendering tests, 14 Chrome and mobile WebKit browser checks, package inspection, and React 18 and Next.js tarball consumers.

Playground · npm package

FeltForge 0.2.1

Adds the chosen Contact shadow to chips and fixes mobile card shadows in the playground.

• Single chips and every visible chip in a stack now have two independent Contact shadow layers, enabled by default and scaled with the chip geometry.
• Remove shadows with shadow={false}, or replace them through --chip-shadow or style.filter. The README and API reference include defaults, scaling and override examples.
• Explore chip sizes, shadow controls, and 64px/28px comparisons on felt and navy in the playground.
• Playground card shadows now render on rounded outer faces, and hidden reverse artwork stays hidden during flips in mobile Safari.
• Chip geometry, palettes and configurable live labels are preserved. No font files or static chip assets are imported.

Validated with 88 unit/rendering tests, 14 Chrome and mobile WebKit browser checks, package inspection, and React 18 and Next.js tarball consumers.

Playground · npm package

FeltForge 0.2.0

Adds compact cards for mobile tables and updates standard cards, Jokers and card backs with the new overridable shadow.

• Compact community cards: 38 × 53; hero cards: 50 × 70. Both support all 52 cards using vector artwork without runtime fonts.
• Import CompactCard from feltforge/compact-card, or use Card with variant="compact".
• Override or remove card shadows through --card-shadow or style.boxShadow.
• Explore both compact sizes, actual-size hands and shadow controls in the playground.
• Keep the three decorative hero cards equally sized on mobile and fix responsive card backs in the Poker table.
• Update the README and API documentation with sizing, imports and shadow customization.

Validated with 86 unit/SSR tests, 10 browser checks, asset comparisons, package checks, and React 18 and Next.js tarball consumers.

Playground · npm package

FeltForge 0.1.1

FeltForge’s playground is now hosted at saeedet.github.io/feltforge. The three large cards in its header are static again; cards in the gallery and poker table retain click flips, drag and flick rotation, hover tilt, and reduced-motion support. The README now opens with a screenshot of the table.

The npm package keeps the same library API and artwork as 0.1.0. Its README and artwork provenance are clearer, and its homepage points to the playground. Future matching version tags trigger the checked, trusted npm publishing workflow automatically.

Validation: workspace and visual checks, nine Chromium interaction tests, and installs of the release tarball into React 18 and Next.js consumers passed. This release was published through npm trusted publishing with a signed provenance statement.

FeltForge 0.1.0

FeltForge’s first public npm release provides typed React primitives for playing cards, chips, chip stacks, markers and poker tables, backed by framework-independent geometry and 31 optimized vector assets.

The court, Joker, and card-back artwork included in FeltForge is original artwork created for this project and is distributed under the MIT License.

npm install feltforge

• Persian, Western and Eastern court collections, two Jokers, Classic card back and custom Ace of Spades.
• Reusable rank and suit vectors for composing playing cards.
• Accessible React components, configurable colours and normalized table overlays for 2/6/8/9 seats.
• Playground with independent click flips, drag/flick rotation, hover tilt and reduced-motion support on every card.
• ESM and TypeScript declarations; React 18 and 19 compatibility verified with actual tarball consumers and a Next.js production build.

Validation passed: 84 unit/SSR/visual tests, nine remote Chromium checks, strict types, production build, deterministic assets, npm packing and consumer checks. Number-card consumers are 8.7 KB gzipped with React external; court illustrations are imported separately.

npm package · API · Publication record

The attached tarball is the same verified package published to npm. Default source builds remain private, and release preparation is explicit. The playground’s separately licensed React Bits effect and Motion dependency are excluded from the npm library.