how-to-talk-to-claude/astro.config.mjs

// @ts-check
import { defineConfig } from 'astro/config';
import starlight from '@astrojs/starlight';

// https://astro.build/config
export default defineConfig({
	integrations: [
		starlight({
			title: 'How to Talk to Claude',
			description: 'A comprehensive guide to AI collaboration skills - for humans',
			logo: {
				src: './src/assets/logo.svg',
			},
			social: [
				{ icon: 'github', label: 'GitHub', href: 'https://github.com/your-username/how-to-talk-to-claude' }
			],
			sidebar: [
				{
					label: 'Beginners Guide',
					badge: 'Start here',
					collapsed: false,
					items: [
						{
							label: 'Start Here',
							items: [
								{ label: 'Introduction', link: '/beginners/start/introduction/' },
							],
						},
						{
							label: 'Tutorials',
							badge: '3 guides',
							collapsed: false,
							items: [
								{ label: 'First Conversation', link: '/beginners/tutorials/first-conversation/', badge: 'New to AI?' },
								{ label: 'Messy Ideas to Results', link: '/beginners/tutorials/messy-ideas/' },
								{ label: 'Creative Collaboration', link: '/beginners/tutorials/creative-project/' },
							],
						},
						{
							label: 'How-To Guides',
							badge: '13 guides',
							collapsed: true,
							items: [
								{
									label: 'Communication & Style',
									collapsed: true,
									items: [
										{ label: 'Ask When Uncertain', link: '/beginners/how-to/ask-when-uncertain/' },
										{ label: 'Match Your Tone', link: '/beginners/how-to/match-tone-style/' },
										{ label: 'Fix Misunderstandings', link: '/beginners/how-to/fix-misunderstandings/' },
									],
								},
								{
									label: 'Information & Research',
									collapsed: true,
									items: [
										{ label: 'Fact-Check Answers', link: '/beginners/how-to/fact-check/' },
										{ label: 'Avoid Walls of Text', link: '/beginners/how-to/avoid-walls-of-text/' },
										{ label: 'Get Useful Sources', link: '/beginners/how-to/get-useful-sources/' },
										{ label: 'Research Unfamiliar Topics', link: '/beginners/how-to/research-unfamiliar-topics/' },
										{ label: 'Organize Information', link: '/beginners/how-to/organize-information/' },
									],
								},
								{
									label: 'Creative & Personal Work',
									collapsed: true,
									items: [
										{ label: 'Brainstorm Comfortably', link: '/beginners/how-to/brainstorm-comfortably/' },
										{ label: 'Get Helpful Feedback', link: '/beginners/how-to/get-helpful-feedback/' },
										{ label: 'Personal Decisions', link: '/beginners/how-to/personal-decisions/' },
										{ label: 'Maintain Your Voice', link: '/beginners/how-to/maintain-voice-writing/' },
									],
								},
								{
									label: 'Advanced Techniques',
									collapsed: true,
									items: [
										{ label: 'Persona Prompts', link: '/beginners/how-to/persona-prompts/' },
									],
								},
							],
						},
						{
							label: 'Explanations',
							badge: '4 guides',
							collapsed: true,
							items: [
								{ label: 'Conversations vs Commands', link: '/beginners/explanations/conversations-vs-commands/' },
								{ label: 'Psychology of Collaboration', link: '/beginners/explanations/psychology-collaboration/' },
								{ label: 'How Claude Thinks', link: '/beginners/explanations/how-claude-thinks/' },
								{ label: 'Making AI Work for Life', link: '/beginners/explanations/making-ai-work-for-life/' },
							],
						},
						{
							label: 'Quick Reference',
							items: [
								{ label: 'Conversation Starters', link: '/beginners/reference/' },
							],
						},
					],
				},
				{
					label: 'Intermediate Guide',
					badge: 'Coming soon',
					collapsed: true,
					items: [
						{
							label: 'Tutorials',
							badge: '4 guides',
							collapsed: false,
							items: [
								{ label: 'Multi-Session Projects', link: '/intermediate/tutorials/multi-session-projects/', badge: 'Preview' },
								{ label: 'Teaching Your Domain', link: '/intermediate/tutorials/teaching-your-domain/', badge: 'Preview' },
								{ label: 'Collaborative Research', link: '/intermediate/tutorials/collaborative-research/', badge: 'Preview' },
								{ label: 'Creative Co-Creation', link: '/intermediate/tutorials/creative-co-creation/', badge: 'Preview' },
							],
						},
						{
							label: 'How-To Guides',
							badge: 'In development',
							collapsed: true,
							items: [
								{
									label: 'Project & Workflow',
									collapsed: true,
									items: [
										{ label: 'Maintain Context', link: '/intermediate/how-to/maintain-context/', badge: 'Preview' },
									],
								},
							],
						},
						{
							label: 'Explanations',
							badge: 'In development',
							collapsed: true,
							items: [
								{ label: 'Extended Partnership', link: '/intermediate/explanations/extended-partnership/', badge: 'Preview' },
							],
						},
					],
				},
			],
			customCss: [
				'./src/styles/custom.css',
			],
		}),
	],
});