nuxt / nuxt/modules

[Module Listing Request]: `@shooteger/nuxt-stripe`

Open
#1,487 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

module-request
Dominant language
TypeScript
Stars
1.1k
Forks
354
Avg merge
10h 18m
Merged PRs (30d)
12

Description

Description

This module provides a clean, actively maintained Stripe wrapper integration for Nuxt, supporting both server-side and client-side usage via composables (useServerStripe(event) and useClientStripe()). I need it myself, as the original used fixed stripe package version, and I needed newer stripe api versions.

It was originally forked from the now-archived @unlok-co/nuxt-stripe (by flozero), where I contributed before it got archived too. I made some distinct changes to the original:

  • Stripe packages are now peer dependencies: no duplicate instances, no constant update churn in the module itself. It only required Stripe versions (stripe >= 17, @stripe/stripe-js >= 5)
  • @stripe/stripe-js is fully optional: only required for client-side UI features
  • Full TypeScript support with re-exported types (ServerStripe, Stripe, StripeElements, etc.)
  • Nuxt 3 and 4 compatible (minimum 3.1.0)
  • Runtime config support with automatic env var pickup (NUXT_STRIPE_SECRET_KEY, NUXT_PUBLIC_STRIPE_PUBLISHABLE_KEY): I renamed the variables to make it as clear as possible, which key can be public and which is meant for server side work
  • Manual client load mode (manualClientLoad: true) for lazy initialization (already in the original repo)
  • Real Tests, Built with @nuxt/module-builder, tested with @nuxt/test-utils and Vitest: I am not the best at writing test, I would welcome here some guidance, but I think I pretty much covered the most cases.

For all features and how-tos, I welcome you to read the README.md: https://github.com/Shooteger/nuxt-stripe/blob/main/README.md

Repository

https://github.com/Shooteger/nuxt-stripe

npm

https://www.npmjs.com/package/@shooteger/nuxt-stripe

Nuxt Compatibility

Nuxt 3, Nuxt 4

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start by reading the linked README.md and reviewing how the Nuxt modules repository represents module listings. Verify the repository and npm package details, Nuxt compatibility, and integration features described in the issue. Done means the @shooteger/nuxt-stripe module is accurately added to the directory with its documented metadata.

Written by the indexing model from the issue text.

Assessment

Tech stack
nuxtjs, typescript
Domain
developer-experience, documentation
Issue type
Feature
Difficulty
2/5
Estimated time
1-3 hours
Activity status
Quiet
Clarity
Mostly clear
Newbie friendliness
45/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.