Version v1 - Deprecated

Configuration Guide (v1)

Deprecated: This guide is for v1. See the v2 configuration guide for current options.

Basic Configuration

Edit astro.config.mjs:

import shipyard from '@levino/shipyard-base'
import shipyardDocs from '@levino/shipyard-docs'

export default defineConfig({
  integrations: [
    shipyard({
      siteTitle: 'My Project',
      siteTagline: 'A great project',
      brandName: 'MyApp',
    }),
    shipyardDocs({
      docsRoot: './docs',
    }),
  ],
})

v1 Configuration Options

Site Settings

OptionTypeDescription
siteTitlestringPage title
siteTaglinestringSubtitle text
brandNamestringNavigation brand

Docs Settings

OptionTypeDescription
docsRootstringDocs directory path
editUrlstringGitHub edit URL

Limitations

v1 configuration does not support:

  • Documentation versioning
  • Advanced sidebar configuration
  • Custom theme options

These features are available in v2.

Migrating Configuration

When upgrading to v2, rename these options:

  • siteTitletitle
  • siteTaglinetagline
  • brandNamebrand

See the Migration Guide for complete instructions.