Astro Starter with React, Tailwind & Shadcn UI

A modern starter template for Astro that includes React, Tailwind CSS, and Shadcn UI integration. Features a beautiful hero component with gradient effects and responsive design.

🚀 Features

• ⚡️ Astro - The web framework for content-driven websites
• ⚛️ React - For interactive components
• 🎨 Tailwind CSS - Utility-first CSS framework
• 🎯 Shadcn UI - Re-usable components built with Radix UI and Tailwind
• 📱 Responsive Design - Mobile-first approach
• 🎭 Modern UI - Beautiful gradient effects and animations

🛠️ Quick Start

Clone the repository

git clone https://github.com/digitaldesaster/astro-start.git
cd astro-start

Install dependencies

npm install

Start development server

npm run dev

Your site will be available at http://localhost:4321

📦 Project Structure

/
├── public/
│   └── favicon.svg
├── src/
│   ├── components/
│   │   ├── ui/            # Shadcn UI components
│   │   │   └── button.tsx
│   │   └── Hero.tsx      # Example hero component
│   ├── layouts/
│   │   └── Layout.astro  # Main layout with shadcn theme
│   ├── pages/
│   │   └── index.astro   # Home page
│   └── styles/
│       └── global.css    # Global styles & Tailwind imports
└── package.json

🔧 Commands

⚙️ Customization

Adding Shadcn Components

To add more shadcn components, use the following command:

npx shadcn@latest add [component-name]

For example:

npx shadcn@latest add card
npx shadcn@latest add dropdown-menu

Modifying Components

• UI Components: Find shadcn components in src/components/ui/
• Hero Component: The example hero is in src/components/Hero.tsx
• Theme: Customize colors and styling in tailwind.config.mjs

Adding New Pages

Create new .astro files in the src/pages directory. They will be automatically converted to pages.

📝 License

MIT License

🤝 Contributing

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add some amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

npm create astro@latest -- --template basics

🧑‍🚀 Seasoned astronaut? Delete this file. Have fun!

🚀 Project Structure

Inside of your Astro project, you'll see the following folders and files:

/
├── public/
│   └── favicon.svg
├── src/
│   ├── layouts/
│   │   └── Layout.astro
│   └── pages/
│       └── index.astro
└── package.json

To learn more about the folder structure of an Astro project, refer to our guide on project structure.

🧞 Commands

All commands are run from the root of the project, from a terminal:

👀 Want to learn more?

Feel free to check our documentation or jump into our Discord server.