In this guide I will show you to create a static single-page application with VueJS and ES6 Modules.
A friend of mine was trying to use AWS Cloud9 to build his SPA, but he found working with Node to be cumbersome due to the way Cloud9 works. I had designed a way to build a complex web application without using Node at all while at work. I passed the knowledge on to him and he took to it.
The idea is that you can build a "static-first" web application with optional build tooling later if you wish.
Rather than using Node's module system, you can use the one that's built into JavaScript. This module system shipped in version 6.
This allows you to send your files to the browser exactly as they are. There is no setup. You can clone a git repository directly to /var/www/html on Apache and start developing.
You can use Vanilla JavaScript, but I've found Vue.js does the heavy lifting that I'd have to do anyway in a moderately complex app.
You will need a server to host your static files. I recommend fenix.
You will need to use a browser that supports ES6, such as Opera.
You can see the final code here.
I have encountered problems with Edge when using this methodology, but Rollup.js has been very useful when preparing the app to work cross-browser.
I am in the process of building a CLI that will automate these steps.
Step 1 - Creating your index.html file.
For the most part, your index.html file will remain untouched as most of your work will be done in JavaScript.
- Create a project folder with a name of your choosing. Serve it from whatever static fileserver you wish.
- Inside the project folder, create an index.html file.
- Add html, head, and body tags, then include this line of code between your body tags:
<script type="module" src="main.js">
You can optionally include 'crossorigin' if you run into a 499 error in the console. There is more information in this forum post.
- Above the line of code you just wrote, add the following:
<div id="app"></div>
You can call the id whatever you want, as long as it matches with the Vue instance we're about to create.
Step 2 - App entry point, and Vue integration.
Vue can be imported as an ES6 module. All components will be able to make use of it.
You should be in a directory that a single file, which is the index.html file you just created.
- Create a main.js file.
- Create a vue.js file.
- Go to this cdn and select vue.esm.browser.js
- Copy and paste the JavaScript code into the vue.js file you just created in your project.
- Go to main.js and enter the following code:
import Vue from './vue.js'
Alternatively, you can do this:
import Vue from 'https://cdn.jsdelivr.net/npm/vue@latest/dist/vue.esm.browser.min.js'
Thanks to Mohamed Safouan Besrour on Github for the suggestion and Pull Request!
- Immediately after this line, add the Vue instance:
new Vue({
el: '#app', // This should be the same as your <div id=""> from earlier.
components: {
'navbar': Navbar
},
template: MainTemplate
})
We've referenced two external files, one component, and one template. We will be importing both. The 'navbar' component has its own template, which it will import on its own, without it having to be imported into main.js
This is important as we want to practice separation of concerns within our componentized app.
Step 3 - Adding templates.
For the apps I have built with this methodology, I have kept all templates in a separate folder structure that mirrors the component folder structure. You can change this around if you want. There is no reason why you can't give each component its own folder with template, and .js file. This is similar to the approach taken by Angular.
- Create a templates directory. This should be the only subfolder in your application directory.
- Create a file called main-template.js
- Add the following code:
// Note that these are backticks.
const MainTemplate = `
<div>
<navbar></navbar>
All content will appear below the horizontal line.
<hr>
</div>
`
export { MainTemplate }
- In the templates folder, create a navbar-template.js file.
- Add the following code:
const NavbarTemplate = `<nav>
<a href="#/">Home</a>
<a href="#/about">About</a>
</nav>`
export { NavbarTemplate }
We have finished creating our templates.
Step 4 - Adding components.
We need a navbar component to attach our template to.
- In the root directory of your project, create a 'components' directory.
- Create a navbar.js file.
- Add the following code:
import { NavbarTemplate } from '../templates/navbar-template.js'
const Navbar = {
template: NavbarTemplate,
}
export { Navbar }
- Return to main.js
Step 5 - Importing our components.
We are almost ready to view the first version of our web application.
- In main.js, add the following code between the Vue import, and the Vue instantiation:
import {
Navbar
} from './components/navbar.js'
import {
MainTemplate
} from './templates/main-template.js'
- Save the file and view your web application in your browser. The URL will depend on your server settings.
We have a web application that can optionally be turned into a SPA. We will do this now.
Step 6 - Adding routing.
We need to import Vue Router. This is optional, but again it does much of the heavy lifting for you when it comes to routing.
- Navigate to the vue-router CDN. There doesn't appear to be an ES6 Modules compatible version, so we'll import as CDN.
- Copy the link, and add it as a dependency in index.html above the module import:
<script src="https://cdnjs.cloudflare.com/ajax/libs/vue-router/3.0.2/vue-router.js"></script>
- Return to main.js and add the following code:
Vue.use(VueRouter)
const router = new VueRouter({
routes: [{
path: '/about',
component: About,
name: "About Us Page"
}]
})
- In the Vue instance add 'router' above main template:
router,
template: MainTemplate
- Create an about template, an about component, and then import the component into main.js
- Underneath the hr tag in main-template.js, add:
<router-view></router-view>
- Look at your app home page, and then use the navbar to route to the about page.
Add new components and templates to expand your app.
Check the console. If you see any errors, or the app is not rendering the way you expected, check that you followed the steps correctly. If it still does not work, leave a comment below the post.
The main point of this methodology is to show that you don't necessarily need to setup a complex build environment with Node in order to develop a SPA. I believe that this type of development will become more sustainable as module developers release ES6-compatible versions of their software.
A future blog post will focus on using Rollup.js to package this type of app, and setting up CI/CD.
I found another bug with the V2 editor. It causes the numbering to reset after a code block. Notice how my numbers are now 1. after every code block is closed. I will reach out to DEV on Twitter concerning the bug.
I hope this helps anyone who was hoping to build a complex web application with just HTML, CSS, and JavaScript.
Thank you.
Top comments (72)
nice article :) but attaching css on each component is quite difficult on this, you need to hack around so that you can have it for example
by the way heres one of my example
plnkr.co/edit/tjhkcfNO15aTNhsU?pre...
Yeah, I know. It's unfortunate that CSS is not modularized like JavaScript is. It would be nice if Vue supported binding CSS to components without build tools. I'm not sure if that's on their roadmap.
For now, the best way I can think of is to use prefixed styles for each component and put them in global CSS so that it's clear which CSS ruleset is meant to affect what.
Thanks for the comment.
i updated the example to make use
goober
css in js it uses prefix to share css :)now problem solve with vue without bundler
plnkr.co/edit/tjhkcfNO15aTNhsU
This is amazing! I didn't know about this. You can just import Goober from the CDN as an ES6 module and contain the CSS in a multiline string just like the template.
I think I need to update the article to reflect this. I will be sure to try this out in my projects.
I really appreciate the work you've put into this. Thanks for telling me about Goober and thanks for using my template!
have you heard
import maps
? you can use polyfill i thinkimport maps
it is already in draft not sure what stage it is.It's not on any stage because it's not on the W3C standards track. Maybe it will be picked up at some point.
I'm not sure what the benefit of this is over <script src="" or import Vue from 'vuecdn.com'
I hadn't heard of this though, and I'd like to know more.
yeah your right its not even in draft, i think in my opinion the benefit is you dont need to type/copy or write long url and you can easily find what are your dependencies. :)
another thing is for example (module 1 dependencies of module 2, but the module 1 didnt use the URL)
module 1
module 2
I had thought that this would essentially replace the package.json file.
If so, then import maps bring us one step closer to building data-driven web applications without Node or NPM.
It's still not on standards track, it seems - though it is available and enabled by default in Chrome and Edge.
caniuse.com/import-maps
Pretty cool - this basically is the web equivalent of package.json 🙂
The main benefit of this is not about long or short URLs - it's about ensuring that, when several modules depend on the same things, they're also loading the same versions of those things. CDNs such as Snowpack try to address this by allowing URLs with version constraints, and performing redirects, but that's a half measure - it doesn't perform or scale well, doesn't let you lock to a specific version, etc...
We really need import-maps to proliferate into a standard. By then, for the first time in the history of the web, the platform will actually be able to stand alone, without all the clunky build tools and bundlers. 😄✊
That's what I'm hoping! Much of the Node.js ecosystem is designed to accommodate the missing features in JavaScript and the web browser. It's too bad, because while the transition is needed, it will be a long one.
I didn't even know that import maps were used in Chrome and Edge. That just leaves Firefox and Safari if browser developers wanted to implement this without a standard, though I would prefer the standard existed.
You want deterministic dependencies. More than once, a buggy update to a single, one-liner package has broken millions of projects in a day. It's a good thing someone else agrees.
Maybe in 5 years, all the features we're talking about today will replace NPM dependence entirely.
That's actually impressive that a feature from backbone and request.js is finally make it into webkit based browsers.
Awesome tutorial!
I would like to add a vuejs frontend to my backend (using spring boot). Is it possible to start the vuejs frontend off of the backend? It doesn't work just routing to the index.html...
Thank you!
You wish to serve the Vue.js frontend from your Spring Boot API? Unfortunately I don't know much about Java, but I do know that my tutorial can be run from any static file server.
What specifically doesn't work?
So basically my backend calls the index.html when I open my localhost in the browser. To test it, I added a simple h1 test before the div id="app" and I can see that. But I get an error saying 'failed to load resource' main.js. I double-checked again, in all javascript files I have the exact same code as you.
Does it give you error 499? You might try adding crossorigin to the HTML element. You should be able to see this in the article where I add in the main.js import to index.html
Which browser are you using?
Do you have script type="module"?
Are the two files in the same part of the directory?
Thank you for using this methodology. I would like to help you solve this problem. When we do, I can add the solution to the original post.
I tried it with both Chrome and firefox. I did add type=module in the script tag. And yes, index.html and main.js are part of the same directory.
I will share my code on github with you. Maybe we will be able to find the reason for the error together and see whether it is an error that occurs more often in that context...
I would be happy to assist you. Could you please link the exact file or folder you would like me to look at?
in the src/main/resources/templates you can find the index.html as well as the main.js
Thank you for your response. I will have a look at this after work.
Hey, @asaux19 I just wanted to let you know that I'm still looking at your issue. I've been easier than expected in the past week and I hope to give you a solution soon.
Quick question. So I can create CSS that isn't SCSS (and scoped to each component). That's very workable. However, how can I assign properties, data, methods, etc. to my components when they are .js files (.vue can include these things, but I'm trying to avoid npm as your solution does).
I'm glad you have your CSS down.
You are able to use anything you expect in the .js file that you could do with any Vue component.
If you find something that doesn't work, I would like to know.
I've tested this extensively. I've put watchers, computed, event listeners, and child components.
Does that answer your question?
Can you paste in an example of the contents of a simple component implementation that has data like an array and property associated with it? In your example stuff there is const with HTML and then an export, but looking for the syntax that's more like what's in a Vue file
A very large example from a personal project:
github.com/arswaw/happyweather/blo...
Another example with props and child components:
github.com/arswaw/happyweather/blo...
I even have an example of mixin use. I will have to find it.
Yes, that's perfect! Thank you!!
Hello
Thanks for the tuto
It work on my server without node js, that the goal and thanks :D
But... If a open the index.html in my local computer, I always have the CORS problem with the
I don't understand why... Have another this same problem?
Well I have find this: npmjs.com/package/http-server
this work when I run the index.html in this http-server localy
Where are you trying to run it that gives you the error?
Can you take a screenshot of where the error is displayed?
Can you share this code as a github repo?
It is now hosted here.
Out of curiosity - why are you loading the router like this:
but not vue.js too?
Because the developers don't include an ES6 compatible version of the router. Only Vue.
EDIT: Now they do.
Good idea. I will work on this tomorrow.
Thanks for this Awesome tutorial!
It is working perfectly on major browser but i am facing problem in Edge browser.
There is no error or warnings in the console.
So if there is any way i would like to know.
Thanks
I have faced this issue before. It comes down to a bug with ES6 Modules in older versions of Edge. If you can, update to the latest version. It uses the same engine as Google Chrome.
If you can't update, I have used RollupJS to bypass this issue. It will grab all the ES6 Modules and put them in one file. You can use it from the command line.
Does this help.
This is absolutely beautiful. I couldn't make the router work but maybe there's some error I made, anyway I don't care I just plan on "enhancing" page by page (maybe do some ajax loading) and don't need/want node.js in the middle. I think this approach will be improved upon (along with SFC, the final blessing) in the future and will be a game changer for developers like me.
I'm really glad you like it. I hope that you fix your router problem quickly. I wish I had seen your comment earlier so I could help but you seem to be managing fine since you're not making a SPA.
I think that Node.js is great but I don't think that the associated ecosystem should be required to make data-driven websites. I hope that more people see my project and find it as useful as you have.
Thanks.
Hi Arswaw I finally made progress with the routing but it became a bit complex with the login/authorization process and all and I quit; I'm not planning to do a SPA (for now!)
My stuff is mostly PHP + Javascript, the traditional. But the ever increasing need for dynamic blocks, which I covered with JQuery (painfully; JQuery is great but not designed for that) I might move to Vue without issue for those "bricks" that I need to add to the page (axios is incredibly straightforward for ajax too).
I now found a very cheap hosting with node.js so now node.js is possible too, but somehow it introduces another layer, and for my usage, this is a very good toolset.
Looking forward to future articles of yours in the matter!
Yeah, router guards can be difficult to set up. I'm guessing that's one of the tasks you had to do to prevent people from gaining unauthorized access by manually typing paths in the address bar.
PHP is tried and true. If it works for you that's great. I'm sure that you'll have no problem transferring that knowledge over to Node.js + Vue. You might also use the Fetch API instead of Axios if you haven't considered that already.
Thanks for your comment! I'd like to write some more articles on this to help spur additional interest from developers like you.
Great job! This looks like an awesome project. Great documentation! I will look at this when I return to my computer.
I'm receiving the error
main.js:8 Uncaught ReferenceError: Cannot access 'router' before initialization
at main.js:8
You should. Define the variable first, then use it
// main.js :
//1
import Vue from 'cdn.jsdelivr.net/npm/vue@latest/di...'
import {
Navbar
} from './components/navbar.js'
import {
About
} from './components/about.js'
import {
MainTemplate
} from './templates/main-template.js'
//2
Vue.use(VueRouter)
const router = new VueRouter({
routes: [{
path: '/about',
component: About,
name: "About Us Page"
}]
})
//3
from earlier.new Vue({
el: '#app', // This should be the same as your
components: {
'navbar': Navbar
},
router,
template: MainTemplate
})
I'm surprised I didn't see your comment. I hope that you were able to fix this error.
this is pure gold. I was just looking for something like this.
Thank you for the appreciation!
This is amazing, thanks a lot for it.
Just a question, how would you add styles/css to the independent components? 🤓
I was recently informed by Jay that you can use Goober CSS as a lightweight ES6-compatible way to add scoped CSS to each component while still avoiding Node.js!
Here's an example that Jay made.
plnkr.co/edit/tjhkcfNO15aTNhsU
That's a really good question. For now I've just been using global styles and then applying specific classes to the template files. An example:
<div class="specific-component-class">
This class is only used for this component, but is stored in a global file like style.css
CSS Modules might be the key, if we can use them without Node.js
Hey
I've found out that you can use scoped CSS to solve that issue. And works flawlessly.
vue-loader.vuejs.org/guide/scoped-...
Great! Thanks a lot it is very very helpful! Can you explain how to install Vue CLI without any package manager? Is that even possible?
Thanks in advance.
I wouldn't bet on it. I will look into it for you, but I will probably end up having to finish a lightweight CLI for non-Node environments.
Your lightweight CLI for non-Node environments will have to be installed with any package manager? About look for if it's possible to install Vue CLI without any package manager, I'm sorry I don't want to waste your time, I just ask because I have googled about installing Vue CLI but everything I've found it's using package managers. My problem with package managers is that I've installed Node (and Yarn) but when I try to install any package I always get errors about SSL wrong versions or other kind. I also tried to find how to fix this but none of the 'solutions' I find works for me. *And I want to jump directly into learn how to develop using Vue or use other frameworks in my projects without becoming an expert in package managers.
I would make it independent of a package manager if I could.
It's unfortunate that you're having so much trouble with NPM. Are you using Windows? Try running command prompt in administrator mode.
You can use the methodology in my article to jump right into Vue development.
Greetings from South Africa 🇿🇦
Thanks for the awesome article. Is there a git repository that I clone to use as reference for this tutorial?
Wow! I can't believe the power of the Internet! My post has reached people all the way in South Africa.
Here is the repository. It's set up to use GitHub's template feature. You should be about to see "Use this template" if you view the repository while logged in. But only if you want to. You can clone like normal.
github.com/arswaw/VueSpaNONODE
Nice article
after dev parcel main.js bundle to minifile it works
my sample vuevm.shopsthai.com
What is that sample?
Sir,
I see your sample "vuevm.shopsthai.com", its awesome,
Can you share the code of your sample, Please ......!!!
Some comments may only be visible to logged-in visitors. Sign in to view all comments.