Custom Components​

Create reusable components for your content:

// src/components/Callout.astro
---
const { type = 'info' } = Astro.props
---
<div class={`callout callout-${type}`}>
  <slot />
</div>

Theme Customization​

Customize your site's appearance with DaisyUI themes:

// tailwind.config.js
module.exports = {
  daisyui: {
    themes: ['light', 'dark', 'cupcake'],
  },
}

SEO Optimization​

shipyard automatically generates:

• Meta tags for social sharing
• Sitemap.xml for search engines
• RSS feeds for blog subscribers
• Canonical URLs

Performance​

Single-language sites benefit from:

• Smaller bundles: No i18n overhead
• Faster builds: Less content to process
• Better caching: Simpler URL structure

Migration Path​

When you're ready for internationalization:

1. Add i18n configuration to Astro
2. Reorganize content into language directories
3. Update internal links
4. Deploy!

shipyard handles the transition smoothly.

Happy building! 🚀

Directory Structure​

Your content lives in straightforward directories:

blog/
├── 2024-09-01-getting-started.md
├── 2024-09-03-content-management.md
└── 2024-09-05-advanced-features.md
docs/
├── index.md
├── installation.md
└── configuration.md

No language subdirectories needed!

Blog Posts​

Each blog post includes frontmatter:

---
title: Your Post Title
description: A brief description
date: 2024-09-03
tags: [tag1, tag2]
---

Documentation​

Documentation pages can be nested in categories:

docs/
├── getting-started/
│   ├── index.md
│   └── quick-start.md
├── guides/
│   ├── index.md
│   └── configuration.md
└── index.md

Benefits of Simplicity​

• Less cognitive load: Focus on content, not structure
• Faster publishing: Write and deploy immediately
• Easier maintenance: Less directories to manage
• Clean URLs: Direct access to your content

Keep it simple and focus on what matters - your content!

Why Choose Single-Language?​

Many websites don't need internationalization from day one. Single-language sites offer:

• Simpler URLs: /blog/post-title instead of /en/blog/post-title
• Easier content management: No language directories to manage
• Faster development: Focus on features instead of translations
• Better SEO: Clean URLs without language prefixes

Key Features​

This blog demonstrates:

1. Clean routing: Posts are accessible directly at /blog/post-slug
2. Standard blog features: Categories, tags, dates, and authors
3. Responsive design: Works great on all devices
4. Easy migration: Can add i18n later if needed

Getting Started​

To create your own single-language shipyard site:

// astro.config.mjs
export default defineConfig({
  // No i18n configuration needed!
  integrations: [
    shipyard({
      title: 'Your Site Name',
      tagline: 'Your awesome tagline',
    }),
    shipyardBlog(['blog']),
  ],
})

That's it! No complex internationalization setup required.

What's Next?​

Check out our documentation to learn more about:

• Setting up your development environment
• Creating and organizing content
• Customizing themes and layouts
• Adding more advanced features

Happy building! 🚀