Skip to main content
Version: 0.15.0

Customizing the App

Each Wasp project can have only one app type declaration. It is used to configure your app and its components.

app todoApp {
  wasp: {
    version: "^0.15.0"
  },
  title: "ToDo App",
  head: [
    "<link rel=\"stylesheet\" href=\"https://fonts.googleapis.com/css?family=Roboto:300,400,500&display=swap\" />"
  ]
}

We'll go through some common customizations you might want to do to your app. For more details on each of the fields, check out the API Reference.

Changing the App Title​

You may want to change the title of your app, which appears in the browser tab, next to the favicon. You can change it by changing the title field of your app declaration:

app myApp {
  wasp: {
    version: "^0.15.0"
  },
  title: "BookFace"
}

Adding Additional Lines to the Head​

If you are looking to add additional style sheets or scripts to your app, you can do so by adding them to the head field of your app declaration.

An example of adding extra style sheets and scripts:

app myApp {
  wasp: {
    version: "^0.15.0"
  },
  title: "My App",
  head: [  // optional
    "<link rel=\"stylesheet\" href=\"https://fonts.googleapis.com/css?family=Roboto:300,400,500&display=swap\" />",
    "<script src=\"https://cdnjs.cloudflare.com/ajax/libs/Chart.js/2.9.3/Chart.min.js\"></script>",
    "<meta name=\"viewport\" content=\"minimum-scale=1, initial-scale=1, width=device-width\" />"
  ]
}

API Reference​

app todoApp {
  wasp: {
    version: "^0.15.0"
  },
  title: "ToDo App",
  head: [
    "<link rel=\"stylesheet\" href=\"https://fonts.googleapis.com/css?family=Roboto:300,400,500&display=swap\" />"
  ],
  auth: {
    // ...
  },
  client: {
    // ...
  },
  server: {
    // ...
  },
  db: {
    // ...
  },
  emailSender: {
    // ...
  },
  webSocket: {
    // ...
  }
}

The app declaration has the following fields:

  • wasp: dict required Wasp compiler configuration. It is a dictionary with a single field:

    • version: string required

      The version specifies which versions of Wasp are compatible with the app. It should contain a valid SemVer range

      info

      For now, the version field only supports caret ranges (i.e., ^x.y.z). Support for the full specification will come in a future version of Wasp

  • title: string required

    Title of your app. It will appear in the browser tab, next to the favicon.

  • head: [string]

    List of additional lines (e.g. <link> or <script> tags) to be included in the <head> of your HTML document.

The rest of the fields are covered in dedicated sections of the docs: