UangCermat Web Toolkit v2

0.2.30 verified Fri May 01 auth: no javascript

A React component library and utility toolkit for building UangCermat financial web applications. Currently at version 0.2.30 (pre-1.0), it ships TypeScript types and requires React 18.2+, react-dom 18.2+, and husky ^8.0.0 as peer dependencies. The package is in early development with a TODO indicating missing test and commit lint setup. Compared to general UI libraries, it is tightly coupled to UangCermat's design system and internal conventions, and may have breaking changes frequently.

Common errors

error FATAL ERROR: Reached heap limit Allocation failed - JavaScript heap out of memory ↓

cause Default Node memory limit insufficient for storybook or build

fix

Set NODE_OPTIONS=--max_old_space_size=8129 in dev script.

error Cannot find module 'react' or 'react-dom' ↓

cause Peer dependencies not installed

fix

Run npm install react@^18.2.0 react-dom@^18.2.0

error TypeError: Cannot read properties of undefined (reading 'colors') ↓

cause Theme object not initialized or imported incorrectly

fix

Ensure import { theme } from 'uangcermat-web-toolkit-v2' is correct and theme provider wraps app.

Warnings

breaking FATAL ERROR: Reached heap limit Allocation failed - JavaScript heap out of memory ↓

fix Increase Node.js max_old_space_size: add 'NODE_OPTIONS=--max_old_space_size=8129' to dev script.

gotcha Package is early stage (v0.2.30) with missing test and commit lint setup; expect frequent breaking changes. ↓

fix Pin to specific version and test upgrades thoroughly.

deprecated Husky v8 is a peer dependency but may be superseded by v9; ensure compatibility. ↓

fix If using husky v9, check for breaking changes and update scripts accordingly.

Install

npm install uangcermat-web-toolkit-v2

yarn add uangcermat-web-toolkit-v2

pnpm add uangcermat-web-toolkit-v2

Imports

Button

wrong

import Button from 'uangcermat-web-toolkit-v2'

correct

import { Button } from 'uangcermat-web-toolkit-v2'

Named export, not default. CJS require works with destructuring.

theme

wrong

const theme = require('uangcermat-web-toolkit-v2').theme

correct

import { theme } from 'uangcermat-web-toolkit-v2'

Also a named export. Supports both ESM and CJS.

useAuth

wrong

import { useAuth } from 'uangcermat-web-toolkit-v2/hooks'

correct

import { useAuth } from 'uangcermat-web-toolkit-v2'

Exported from main entry; no subpath exports documented.

Quickstart

Quickstart showing installation with peer deps, named imports, and usage of Button component with theme.

// Install with peer dependencies
npm install uangcermat-web-toolkit-v2 react@^18.2.0 react-dom@^18.2.0 husky@^8.0.0

// Use in a React component
import { Button, theme } from 'uangcermat-web-toolkit-v2';

function App() {
  return (
    <div style={{ background: theme.colors.primary }}>
      <Button label="Click me" onClick={() => alert('Clicked')} />
    </div>
  );
}

export default App;