Custom webawesome components that I use.
  • JavaScript 77.3%
  • HTML 20.2%
  • Python 2.5%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
2026-10-20 13:47:51 -04:00
.okf ✨ so many new components and docs! 2026-10-20 13:47:51 -04:00
components ✨ so many new components and docs! 2026-10-20 13:47:51 -04:00
scripts ✨ so many new components and docs! 2026-10-20 13:47:51 -04:00
skills/joes-addons ✨ so many new components and docs! 2026-10-20 13:47:51 -04:00
.gitignore 📝 add a reference folder for adapting projects 2026-10-19 12:01:12 -04:00
AGENTS.md 📝 update agent instructions 2026-10-19 11:46:15 -04:00
index.html ✨ so many new components and docs! 2026-10-20 13:47:51 -04:00
jk-webawesome.loader.js Add jk-* autoloader (derived from Web Awesome MIT autoloader) 2026-06-30 00:34:13 -04:00
LICENSE Initial commit 2026-06-29 23:48:29 -04:00
README.md ✨ so many new components and docs! 2026-10-20 13:47:51 -04:00

webawesome-addons

Custom, dependency-free web components that drop in alongside Web Awesome, under a jk- prefix so they never collide with official wa-* components.

Components

  • <jk-tilt> — parallax tilt-on-hover effect with an optional glare overlay.
  • <jk-code-editor> — lightweight editable code surface with auto-indent, bracket pairing, line numbers, undo/redo, and a syntax-highlight hook.
  • <jk-masonry> - responsive, variable-height masonry layout adapted from MiniMasonry, with automatic resizing and configurable gutters.
  • <jk-twemoji> - converts Unicode emoji or canonical English emoji names to Twemoji images, with automatic updates and native-text fallback.
  • <jk-reveal> - SAL-inspired scroll entrance effects with seven presets, repeat mode, reduced-motion support, and keyboard-safe visibility. Try the reveal section in index.html.
  • <jk-scrollspy> - Gumshoe-inspired tracking that applies .active to the current section and navigation link, leaving all highlighting styles to you. Try the scrollspy section in index.html.

See skills/joes-addons/ for full per-component docs.

Twemoji preview

Run python3 -m http.server 8000 from the repository root, then open the emoji grid. No build or package installation is required; Twemoji images load from the pinned CDN as you scroll.

Filter as you type by name, Unicode code points (U+1F483 or 1f483), or the emoji itself. Matching ignores case and updates the visible count. Hover or keyboard-focus any of the 3,944 emoji to see its Unicode and canonical name. Choose Unicode code points (for example, U+1F483) or Emoji name (woman dancing), then click an emoji to copy. If clipboard access is denied, the page selects the value for manual copying.

Usage

  1. Load Web Awesome Free first — these components consume its --wa-* design tokens.

  2. Add the loader (a module script). It auto-discovers any jk-* element on the page, now or added later:

    <script type="module" src="jk-webawesome.loader.js"></script>
    
  3. Use the components:

    <jk-tilt><div class="card">Hover me</div></jk-tilt>
    

The loader strips the jk- prefix and imports components/<name>/<name>.js, resolved relative to the loader file via import.meta.url, so the package works from any path. It also exports startLoader, stopLoader, and discover for manual control.

Local Web Awesome reference

Run with Python 3 and npm available:

python3 scripts/update-webawesome.py

This downloads the latest stable Free package (@awesome.me/webawesome, npm's latest tag) into the gitignored webawesome/ folder. It places the bundled dist-cdn contents there, including components, chunks, styles, and upstream docs, plus the package version and license. The path is relative to the script, so it also works from another working directory.

Subsequent runs check webawesome/package.json and only download when a newer release exists; newer local versions are never downgraded. Missing version metadata triggers a fresh download. Downloads are staged and validated before replacing the old reference, so download/extraction failures preserve it. Malformed version metadata fails with an error instead of silently replacing it. Treat this folder as read-only: updates replace its contents. This does not change the CDN version used by the demo or add npm project dependencies.

Attribution

The autoloader is derived from Web Awesome's MIT-licensed autoloader.