How thenightproject/supaweb3 works
Project Type and Purpose
• This is a monorepo hosting a Vue 3 + TypeScript Web3 UI component library (“@supaweb3/ui”), a Nuxt 3/4 integration module (“@supaweb3/nuxt”), a Tailwind CSS preset (“@supaweb3/config”), and Storybook documentation (“@supaweb3/storybook”).
• Purpose: Provide reusable, tree-shakable Web3 UX components (wallet connect, defi, NFTs, governance, etc.) and integrate them easily into Vue/Nuxt projects.
• It’s an open-source toolkit + integration plugin, not a standalone app.
Key Architectural Elements from File Structure
• Root
• Configuration & tooling: pnpm-workspace, tsconfig, lint/prettier files, GitHub Actions workflows, .changeset for versioning, .claude for CLI sessions.
• scripts/: release/version bump scripts.
• packages/config
• Tailwind CSS preset package.
• packages/ui
• Core component library: src/components (dozens of Vue components), src/composables (shared composables), types, CSS entry point, Vite config.
• packages/nuxt
• Nuxt module: module.ts to auto-import components, add Tailwind preset.
• packages/storybook
• Storybook setup and component stories for interactive documentation.
Insights from README
• Four published packages: @supaweb3/config, /ui, /nuxt, /storybook.
• Tech stack: Vue 3 Composition API, TypeScript, Tailwind CSS v3/v4, Storybook, pnpm.
• CI/CD: GitHub Actions automate publishing to GitHub Packages and NPM.
• Consumer workflows:
• Vue 3 app: import components individually.
• Nuxt app: add @supaweb3/nuxt to modules, auto-import, auto-configure Tailwind.
• Title: “SupaWeb3 Monorepo Architecture”
• workspace→build→registry
• consumer→import→library/module
• config→styled by→UI & Nuxt
• Important patterns: “Tree-shakable imports”, “Auto-import plugin”