10x Astro Starter

A modern, opinionated starter template for building fast, accessible, and AI-friendly web applications.

Tech Stack

• Astro v5.5.5 - Modern web framework for building fast, content-focused websites
• React v19.0.0 - UI library for building interactive components
• TypeScript v5 - Type-safe JavaScript
• Tailwind CSS v4.0.17 - Utility-first CSS framework

Prerequisites

• Node.js v22.14.0 (as specified in .nvmrc)
• npm (comes with Node.js)

Getting Started

1. Clone the repository:

git clone https://github.com/przeprogramowani/10x-astro-starter.git
cd 10x-astro-starter

2. Install dependencies:

npm install

3. Run the development server:

npm run dev

4. Build for production:

npm run build

Available Scripts

• npm run dev - Start development server
• npm run build - Build for production
• npm run preview - Preview production build
• npm run lint - Run ESLint
• npm run lint:fix - Fix ESLint issues

Project Structure

.
├── src/
│ ├── layouts/ # Astro layouts
│ ├── pages/ # Astro pages
│ │ └── api/ # API endpoints
│ ├── components/ # UI components (Astro & React)
│ └── assets/ # Static assets
├── public/ # Public assets

AI Development Support

This project is configured with AI development tools to enhance the development experience, providing guidelines for:

• Project structure
• Coding practices
• Frontend development
• Styling with Tailwind
• Accessibility best practices
• Astro and React guidelines

Cursor IDE

The project includes AI rules in .cursor/rules/ directory that help Cursor IDE understand the project structure and provide better code suggestions.

GitHub Copilot

AI instructions for GitHub Copilot are available in .github/copilot-instructions.md

Windsurf

The .windsurfrules file contains AI configuration for Windsurf.

Contributing

Please follow the AI guidelines and coding practices defined in the AI configuration files when contributing to this project.

License

MIT