nuxt-maintenance-mode

KO | EN

gitlite — search

#typescript #ai-agents #ai #dsh-plugin #deepseek-harness #open-source #cli #claude-code #codex #developer-tools #react #windows

nuxt-maintenance-mode

★ 106 Open GitHub ↗

Maintenance mode module for Nuxt.js.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

**This package is no longer maintained.**

# Maintenance mode module for Nuxt.js

[![codecov](https://codecov.io/gh/potato4d/nuxt-maintenance-mode/branch/master/graph/badge.svg)](https://codecov.io/gh/potato4d/nuxt-maintenance-mode)
[![All Contributors](https://img.shields.io/badge/all_contributors-2-orange.svg?style=flat-square)](https://raw.githubusercontent.com/potato4d/nuxt-maintenance-mode/master/)
[![NPM version](https://img.shields.io/npm/v/nuxt-maintenance-mode.svg?style=flat)](https://npmjs.com/package/nuxt-maintenance-mode)
[![NPM downloads](https://img.shields.io/npm/dm/nuxt-maintenance-mode.svg?style=flat)](https://npmjs.com/package/nuxt-maintenance-mode)
[![CircleCI](https://circleci.com/gh/potato4d/nuxt-maintenance-mode/tree/master.svg?style=shield)](https://circleci.com/gh/potato4d/nuxt-maintenance-mode/tree/master)

A module for displaying the view for maintenance as fallback while maintaining the path.

[![Image from Gyazo](https://i.gyazo.com/96e9a69d2e6449d774c304f827468430.gif)](https://gyazo.com/96e9a69d2e6449d774c304f827468430)

## About this module

A module for displaying the view for maintenance as fallback while maintaining the path.

Instead of accessed routing, render the contents of the routing specified for maintenance and return status code 503 to the client.

This is the easiest and most effective way to put an application in maintenance state without compromising the SEO and the user's access experience.

### Caution

This project is under development.

We welcome aggressive pull requests such as when there is a better implementation.

## Installation

At first, install package from NPM

```bash
$ yarn add nuxt-maintenance-mode # or npm i -S
```

Next, Add 'nuxt-maintenance-mode' value to modules property in nuxt.config.js

```js
module.exports = {
  // ...
  modules: ['nuxt-maintenance-mode']
  // ...
}
```

Last, Add maintenance mode options to nuxt.config.js

```js
module.exports = {
  // ...
  modules: [
    'nuxt-maintenance-mode'
  ],
  maintenance: {
    enabled: !!process.env.MAINTENANCE_MODE, // If given truthy value, activation maintenance mode on startup your nuxt application.
    path: '/maintenance', // maintenance fallback content routing.
    matcher: /^\/admin/ // Path to be in maintenance mode (regex).
  },
  // ...
}
```

## Options

### enabled?: boolean

- default: false
- required: false

If given truthy value, activation maintenance mode on startup your nuxt application.

We recommend specifying the value of the environment variable.

### path: string

- default: undefined
- required: true

maintenance fallback content routing.

The path you set for this property must have a valid routing.

For example, if you specify `/maintenance`, create `pages/maintenance.vue`.

### matcher?: string

- default: undefined
- required: false

Path to be in maintenance mode (regex).

## LICENSE

MIT (c) HANATANI Takuma(@potato4d)

## Contributors

Thanks goes to these wonderful people ([emoji key](https://allcontributors.org/docs/en/emoji-key)):

<table><tr><td align="center"><a href="https://potato4d.me"><img src="https://avatars0.githubusercontent.com/u/6993514?v=4" width="100px;" alt="Takuma HANATANI"/> Takuma HANATANI</a> <a href="https://github.com/potato4d/nuxt-maintenance-mode/commits?author=potato4d" title="Code">💻</a> <a href="#maintenance-potato4d" title="Maintenance">🚧</a> <a href="https://github.com/potato4d/nuxt-maintenance-mode/commits?author=potato4d" title="Documentation">📖</a> <a href="https://github.com/potato4d/nuxt-maintenance-mode/issues?q=author%3Apotato4d" title="Bug reports">🐛</a></td><td align="center"><a href="https://github.com/chrysanthos"><img src="https://avatars0.githubusercontent.com/u/7782312?v=4" width="100px;" alt="Chrysanthos"/> Chrysanthos</a> <a href="https://github.com/potato4d/nuxt-maintenance-mode/issues?q=author%3Achrysanthos" title="Bug reports">🐛</a></td></tr></table>

This project follows the [all-contributors](https://github.com/all-contributors/all-contributors) specification. Contributions of any kind welcome!

nuxt-maintenance-mode

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README