# Routing, layouts, and views
# Overview
This project uses Vue Router, which we initialize in src/router/index.js
, with routes defined in src/router/routes.js
. Inside the src/router
folder, there are also two sub-folders, both containing route-specific components: layouts
and views
.
# Layouts
Every view component must use a layout component as its base and register it as Layout
, as this convention helps us mock out layout components when testing views. Layouts usually aren't very complex, often containing only shared HTML like headers, footers, and navigation to surround the main content in the view. We provide two default layouts, Layout
and LayoutFullScreen
, which are used in the following views: layoutOfHorizontal
and layoutOfVertical
, you can config in project-config.js
.
# Views
Each view component will be used by at least one route in src/router/routes.js
, to provide a template for the page. They can technically include some additional properties from Vue Router to control navigation (opens new window), for example to fetch data (opens new window) before creating the component, but I recommend adding these guards to src/router/routes.js
instead, as that behavior typically has much more to do with the route (and will sometimes be shared between routes) than it does the view component.