pp-karuta

PROMIDAS

PROMIDAS is a library that simplifies data fetching and cache management using the ProtoPedia API v2.

With PROMIDAS, you can efficiently implement data flow between components responsible for API communication, in-memory caching, repository management, and data presentation.

• 🧰 PROMIDAS
• F88/promidas: Snapshot-based in-memory store for ProtoPedia prototypes with TTL management

Utilities to assist development using PROMIDAS

• 🧰 PROMIDAS Utilities
• F88/promidas-utils: Utilities to help with development using PROMIDAS

Tech Stack

Runtime

• Node.js 22+

Core

• TypeScript 5.9 - Type-safe development
• Vite 7 - Fast build tool

Frontend

• React 19 - UI library
• TanStack Router - File-based routing

Content

• react-markdown + remark-gfm - Render INTRO content

UI

• Tailwind CSS 4.x - Utility-first CSS framework
• shadcn/ui components - Copy-paste component collection (Radix UI + CVA)
• Radix UI - Headless UI primitives (used via shadcn/ui)
• class-variance-authority (CVA) - Variant-driven component styling
• tailwind-merge / clsx - Utility class composition
• tailwindcss-animate - Animation utilities
• lucide-react icons - Icon library

Data Management

• ProtoPedia API v2 - Prototype data source
• PROMIDAS - ProtoPedia API data management library
• PROMIDAS Utilities - Utilities to assist development using PROMIDAS

PWA

• vite-plugin-pwa - Progressive Web App support
• Workbox - Service Worker library (via vite-plugin-pwa)
• Web App Manifest - A2HS (Add to Home Screen) support
• @vite-pwa/assets-generator - PWA assets generator from single source image

Deployment

• GitHub Pages - Static hosting
• gh-pages - Deploy dist/ to GitHub Pages

Testing and Documentation

• Vitest 4 - Test framework
• Testing Library - React component testing
• Storybook 10 - UI component documentation

Code Quality

• Prettier - Code formatter
• ESLint 9 - Static analysis
• TypeScript ESLint - Lint rules for TypeScript

Data Source & License / データ出典とライセンス

ProtoPedia Data / ProtoPedia のデータ

This application uses data from ProtoPedia, retrieved through the ProtoPedia API Ver 2.0. ProtoPedia applies the Creative Commons Attribution 4.0 International (CC BY 4.0) license to registered work information by default.

本アプリケーションは、ProtoPediaの作品情報を ProtoPedia API Ver 2.0 を通じて取得し、利用しています。 ProtoPediaでは、登録作品情報に クリエイティブ・コモンズ 表示 4.0 国際(CC BY 4.0) ライセンスが標準適用されています。

Reference: ProtoPedia Help Center