SEO and marketing

To get as many users for your app as possible, it is important to consider search engine optimization and digital marketing.

Get your site known

When your app is ready it's time to let people know about it. The first step is to register it with search engines:

It'll take a few days for your site to turn up in search results. Make sure your web site's titles and meta descriptions makes people click your link!

Here are some other tips:

Speed and response times

Waveorb serves blazing fast pre-rendered HTML and assets with HTML caching (max-age, etags, 304), HTTP2, gzip compression served from NGINX, which is really fast. Web pages served this way appears almost instantly and won't let your users wait.

Pure speed isn't everything though, there are other things to consider as well.

Markup, titles and meta

Proper HTML markup is important to tell search engines about the structure of your site. Titles and description should optimally be unique for each page of your app. In your page you can assign to the $.page object:

module.exports = async function($) {
  $.page.title = 'Waveorb Title'
  $.page.description = 'The page meta description'
  return `Hello`

In your layout use the $.page object values:

`<title>${$.page.title || 'Fallback if no title set'}</title>`
`<meta name="description" content="${$.page.description || 'Fallback description'}">`

The title and meta descripton are what users see when they do an organic search so it's very important that they are relevant so the user clicks your link. Organic search clicks are free and high quality.


To add a sitemap to your site, add your URLs to app/config/sitemap.yml. To generate the sitemap, run the waveorb sitemap command, which will create a sitemap.xml file in your app/assets folder.

If the file exists, the sitemap.xml file will be copied to the dist folder every time you run waveorb build. It will be available in your browser at /sitemap.xml for your domain.

  - url: /
    changefreq: monthly
    priority: 0.9
  - url: /about
    changefreq: weekly
    priority: 0.5

Here is an example taken from a web site running Waveorb with translations:

  - url: /
    lastmodfile: dist/index.html
    changefreq: always
    priority: 1.0
      - url: /en/
        lang: en

Adding a sitemap for all your translations as well as a modification date ensures that search engines will crawl your site effectively.

Waveorb is using the sitemap library to generate the sitemap so all options from there can be used.

You could also just add a sitemap.xml to app/assets and it will be served upon deploy.

If you've added or changed some of your URLs, you can let search engines know about it, just add the URL of your sitemap at the end:


To help search engines navigate your site and find your sitemap, add a robots.txt file in assets root app/assets:


Read more about robots.txt options here.