parasails

library0.9.3jsnpmunverified

parasails is a lightweight (2.96KB gzipped) Vue.js-based framework for building multi-page applications without Webpack, Babel, or other build tools. Version 0.9.3 is the latest stable release. It provides structures for pages, components, utilities, and constants, with optional integrations for Vue Router and jQuery. Designed primarily for use with Sails.js, it offers a simpler alternative to full SPA frameworks by enabling server-rendered pages with client-side interactivity.

web-framework

npm install parasails

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · PARASAILS

parasails

web-frameworkjavascriptv0.9.3

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

parasails

✓ import parasails from 'parasails'

✗ const parasails = require('parasails')

For browser usage, include as a script tag; parasails is not ESM-only, but the recommended way is via ES modules if bundling.

registerPage

✓ parasails.registerPage('pageName', { ... })

✗ parasails.registerPage('pageName', { ... })

registerPage is a method on the default export, not a named import.

registerComponent

✓ parasails.registerComponent('componentName', { ... })

✗ import { registerComponent } from 'parasails'

Same as registerPage; it's a method on the default export.

Shows a basic parasails page with Vue-like data and methods, no build tools required.

<div id="my-page" v-cloak> <h1>{{ message }}</h1> <button @click="updateMessage">Click me</button> </div> <script type="module"> import parasails from 'parasails'; parasails.registerPage('my-page', { data: { message: 'Hello parasails!' }, methods: { updateMessage: function() { this.message = 'You clicked the button!'; } } }); </script>

Debug

Known issues

gotchaparasails requires Vue.js to be available globally (window.Vue) or imported as a module. Ensure Vue is loaded before parasails.

fix

Include Vue via a script tag before parasails, or import it in your module bundler setup.

affects: >=0.7.0

gotchaThe jQuery integration for $get, $find, $focus methods requires jQuery to be loaded. Without jQuery, these methods will not work.

fix

Include jQuery via a script tag or import it if you need those methods.

affects: >=0.7.0

gotchaparasails pages rely on having an element with an id matching the page name. The page will not mount if the element is missing or the id does not match.

fix

Ensure your HTML contains <div id="pageName"> where pageName matches the string passed to registerPage.

affects: >=0.7.0

Errors

Common errors & fixes

Cannot read property 'registerPage' of undefined

parasails is not loaded or the import is incorrect.

fix

Check that parasails is correctly imported via script tag or ES module, and that it is available as a default export.

Vue is not defined

Vue.js is not loaded before parasails.

fix

Load Vue.js via a script tag before parasails, or import it in your bundler.

Error: [parasails] Could not find a <div> with id "..."

The HTML page does not contain an element with the id matching the registered page name.

fix

Add an element with the correct id, e.g., <div id="pageName">.

Upgrade

Version history

0.9.3latest on npm

Audit

Dependencies

vuerequiredBuilt on top of Vue.js for reactivity and component system.

Agent activity

2 hits · last 30 days

node

Resources

githubhttps://github.com/mikermcneil/parasails ↗

packagehttps://www.npmjs.com/package/parasails ↗

homepagehttps://parasails.com ↗