nuxt-modules / ngrok

ngrok exposes your localhost to the world for easy testing and sharing! No need to mess with DNS or deploy just to have others test out your changes
https://ngrok.nuxtjs.org/
68 stars 13 forks source link
ngrok nuxt

@nuxtjs/ngrok

Nuxt ngrok

npm version npm downloads License Nuxt

Easily expose your Nuxt application to the internet with ngrok.

Features

Setup

  1. Install @nuxtjs/ngrok:
npx nuxi@latest module add ngrok
  1. Add @nuxtjs/ngrok to the modules section of nuxt.config.ts:
export default defineNuxtConfig({
  modules: [
    '@nuxtjs/ngrok',
  ],

  ngrok: {
    // module options
  },
})

That's it! You can now use ngrok in your Nuxt app ✨

for Nuxt 2 support, please use @nuxtjs/ngrok@2.0.0 and follow the instructions at v2.nuxtjs.org

Options

Add authorization and more using the module options:

export default defineNuxtConfig({
  modules: [
    '@nuxtjs/ngrok',
  ],

  ngrok: {
    authtoken_from_env: true, // Use NGROK_AUTHTOKEN environment variable
    // authtoken: 'your_ngrok_authtoken', // Or use this option
    auth: 'username:password',
    domain: 'your_custom_domain',
    production: true,
  },

})

learn more about the module options.

Usage

Now if you run your Nuxt application, you should see a message in your console that shows the ngrok URL.

✔ Ngrok connected at https://your_ngrok_url

Contribution

Local development ```bash # Install dependencies npm install # Generate type stubs npm run dev:prepare # Develop with the playground npm run dev # Build the playground npm run dev:build # Run ESLint npm run lint # Release new version npm run release ```