Getting Started with Your New Blog

Welcome to your new blog powered by your new blog! This guide will help you get started with setting up and customizing your blog.

Initial Setup

1. Configure Your Site

Edit src/consts.ts to customize your site information:

1
export const SITE: Site = {
2
  title: 'Your Blog Name',
3
  description: 'Your blog description',
4
  href: 'https://yourdomain.com',
5
  author: 'your-author-id',
6
  // ...
7
}

Customize your navigation links in src/consts.ts:

1
export const NAV_LINKS: SocialLink[] = [
2
  { href: '/blog', label: 'Blog' },
3
  { href: '/about', label: 'About' },
4
  // Add more links as needed
5
]

Update your social media links:

1
export const SOCIAL_LINKS: SocialLink[] = [
2
  { href: 'https://github.com/username', label: 'GitHub' },
3
  { href: 'https://twitter.com/username', label: 'Twitter' },
4
  { href: 'mailto:[email protected]', label: 'Email' },
5
]

Creating Content

Blog Posts

Create new blog posts in src/content/blog/:

Create a folder for your post: src/content/blog/my-post/
Add an index.mdx file with frontmatter:

1
---
2
title: "My First Post"
3
description: "A brief description"
4
date: 2025-01-16
5
tags: ["tag1", "tag2"]
6
draft: false
7
---

Write your content using Markdown or MDX

Tip

Pro Tip: You can use MDX components like Callout, Code blocks, and more in your posts!

Author Profiles

Create author profiles in src/content/authors/:

1
---
2
name: 'Your Name'
3
avatar: 'https://gravatar.com/avatar/...'
4
bio: 'Your bio'
5
github: 'https://github.com/username'
6
---

Customization

Colors

Edit src/styles/global.css to customize your color scheme:

1
:root {
2
  --primary: hsl(214 95% 52%);
3
  /* Customize other colors */
4
}

Homepage Experience

Edit src/pages/index.astro to customize your experience timeline:

1
const experience: ExperienceItem[] = [
2
  {
3
    role: 'Your Role',
4
    company: 'Company Name',
5
    period: '2020 - Present',
6
    current: true,
7
    icon: 'lucide:briefcase',
8
    key: 'Your achievements and responsibilities'
9
  },
10
]

Optional Features

Sign up for Brevo
Get your API key

Add to .env:

1
BREVO_API_KEY=your-api-key
2
BREVO_LIST_ID=your-list-id

Disqus Comments

Create a Disqus account
Add to .env:
```
1
PUBLIC_DISQUS_SHORTNAME=your-shortname
```

Analytics

Add Google Analytics or Umami:

1
PUBLIC_GOOGLE_ANALYTICS_ID=G-XXXXXXXXXX
2
PUBLIC_UMAMI_WEBSITE_ID=your-umami-id

Next Steps

Delete example content - Remove hello-world and getting-started posts
Update About page - Customize src/pages/about.astro
Update Privacy & Terms - Review and customize legal pages
Add your content - Start writing your blog posts!

Resources

Happy blogging! 🎉