Install & Compatibility
Where this runs
No compatibility data collected yet for this library.
Code
Verified usage
Verified import paths — ran on the pinned version, not inferred.
ArwesThemeProvider
✓ import { ArwesThemeProvider } from '@arwes/react'
✗ import { ArwesThemeProvider } from 'arwes'
Main package is @arwes/react; 'arwes' is legacy. ESM only.
Animation
✓ import { Animation } from '@arwes/animation'
✗ import { Animation } from '@arwes/core'
Animation tools are in @arwes/animation, not @arwes/core.
FrameSVG
✓ import { FrameSVG } from '@arwes/react-frames'
✗ import { FrameSVG } from '@arwes/react'
Frame components are in @arwes/react-frames since v1.0.0-alpha.20.
BleepsProvider
✓ import { BleepsProvider } from '@arwes/react-bleeps'
Sound effects provider, separate from core package.
Sets up Arwes theme provider, baseline styles, and renders a Text heading with a Button.
import React from 'react';
import { ArwesThemeProvider, StylesBaseline, Text, Button } from '@arwes/react';
import { createTheme } from '@arwes/design';
const theme = createTheme();
function App() {
return (
<ArwesThemeProvider theme={theme}>
<StylesBaseline />
<div style={{ padding: 20 }}>
<Text as="h1">Welcome to Arwes</Text>
<Button palette="primary">
Activate
</Button>
</div>
</ArwesThemeProvider>
);
}
export default App;
Debug
Known issues
breakingPackage structure changed in v1.0.0-alpha.20: components moved to subpackages (e.g., @arwes/core, @arwes/react-frames). Import paths from old monolith are invalid.fixUpdate imports to use the correct subpackage, e.g., @arwes/react-frames for FrameSVG.
affects: >=1.0.0-alpha.20
breakingUMD/CommonJS builds removed; only ESM format is provided since v1.0.0-alpha.16.fixUse ESM imports; if CommonJS needed, use bundler or dynamic import.
affects: >=1.0.0-alpha.16
deprecatedThe 'arwes' top-level package is deprecated; use '@arwes/react' and other subpackages instead.fixInstall @arwes/react and import from it, not from 'arwes'.
affects: >=1.0.0-alpha.20
gotchaBleeps (sound effects) require AudioContext; they will silently fail if not available.fixEnsure AudioContext is available or disable bleeps via BleepsProvider settings.
affects: >=1.0.0-alpha.22
Errors
Common errors & fixes
Module not found: Can't resolve '@arwes/core'
Trying to import from '@arwes/core' which does not exist; correct package is '@arwes/react' or other subpackages.
fixReplace import '@arwes/core' with import '@arwes/react' (or the correct subpackage)
TypeError: Cannot read property 'createTheme' of undefined
Importing createTheme directly from 'arwes' (deprecated) instead of '@arwes/design'.
fixChange import to: import { createTheme } from '@arwes/design'; Warning: React version mismatch. Expected 17.x, got 18.x
Arwes v1.0.0-next currently peer depends on React 17.
fixDowngrade React to 17 or use Arwes with --legacy-peer-deps (experimental).
Upgrade
Version history
1.0.0-next.25020502latest on npm
Audit
Dependencies
reactrequiredPeer dependency for React components
react-domrequiredPeer dependency for React DOM rendering
@emotion/reactoptionalCSS-in-JS styling (peer dependency for @arwes/design)
@emotion/styledoptionalStyled components (peer dependency for @arwes/react)