Build Beautiful Websites with shipyard

shipyard is your complete toolkit for building stunning documentation sites, blogs, and content-focused websites with Astro.

Stop wrestling with complex configurations and start creating. shipyard gives you everything you need: responsive design, intelligent navigation, internationalization, and modular components that work together seamlessly.

Why Choose shipyard?

• Ready to Launch – Get your site running in minutes, not hours
• Mobile-First – Beautiful on every device with Tailwind CSS and DaisyUI
• Global Ready – Optional internationalization with locale-based routing
• Modular Design – Use only what you need, extend as you grow
• Content-Focused – Automated organization and collection for your content

---

Packages

shipyard consists of three packages that work together:

Package	Purpose	Documentation
@levino/shipyard-base	Core layouts, components, navigation, and configuration	View Docs →
@levino/shipyard-docs	Documentation features, sidebar, pagination, git metadata	View Docs →
@levino/shipyard-blog	Blog functionality, post listing, navigation	View Docs →

---

Quick Start

Installation

npm install @levino/shipyard-base @levino/shipyard-docs @levino/shipyard-blog
npm install tailwindcss daisyui @tailwindcss/typography @astrojs/tailwind

Configuration

// astro.config.mjs
import tailwind from '@astrojs/tailwind'
import shipyard from '@levino/shipyard-base'
import shipyardDocs from '@levino/shipyard-docs'
import shipyardBlog from '@levino/shipyard-blog'
import { defineConfig } from 'astro/config'

export default defineConfig({
  integrations: [
    tailwind({ applyBaseStyles: false }),
    shipyard({
      brand: 'My Site',
      title: 'My Awesome Site',
      tagline: 'Built with shipyard',
      navigation: {
        docs: { label: 'Docs', href: '/docs' },
        blog: { label: 'Blog', href: '/blog' },
      },
    }),
    shipyardDocs(),
    shipyardBlog(),
  ],
})

Read the full Getting Started guide →

---

Live Demos

Explore shipyard’s features in action with our demo sites:

Demo	Description
Single Language	Basic shipyard setup with docs and blog
Internationalization (i18n)	Multi-language site with locale-based routing
Server Mode	Server-side rendering (SSR) with on-demand page generation

Each demo showcases different shipyard capabilities. The source code for all demos is available in the demos directory.

---

Documentation Overview

Getting Started

• Why shipyard? – The motivation and philosophy behind shipyard
• Getting Started – Installation, configuration, and project setup

Package Reference

• @levino/shipyard-base – Core configuration, layouts, and components
• @levino/shipyard-docs – Documentation plugin with sidebar and pagination
• @levino/shipyard-blog – Blog plugin with post listing and navigation

Guides

• Markdown Features – Admonitions, code blocks, tabs, and more
• Announcement Bar – Dismissible site-wide banners
• Blog Authors & Tags – Author profiles, tags, feeds, and archive

Additional Resources

• Server Mode (SSR) – Using shipyard with server-side rendering
• Feature Roadmap – Docusaurus feature parity status and upcoming features

---

Perfect for developers, content creators, and anyone who wants a beautiful, fast website without the complexity.