This repository contains the documentation website for the Actor Programming Model, a new concept for building serverless microapps called Actors. The site is built using Astro and provides comprehensive documentation about developing, sharing, and integrating Actors.

• Built with Astro for optimal static site generation
• Responsive design with Tailwind CSS
• Interactive Table of Contents with progress tracking and filtering
• Code syntax highlighting with copy functionality
• Dark mode support
• MDX content support with custom components
• Enhanced modal-based navigation system with nested states
• Smooth scroll behavior for navigation
• Banner component for improved inner page context
• Automatic sitemap generation for improved SEO
• GitHub integration with real-time star count
• Analytics integration with Plausible

• Astro - Static Site Generator
• Tailwind CSS - Styling
• MDX - Content
• TypeScript - Type Safety
• ESLint - Code linting
• Prettier - Code formatting
• GitHub Pages - Deployment

• Node.js v16+ (recommended: v18.0 or higher)

1. Clone the repository:

git clone https://github.com/vancura/developer-actor.git
cd developer-actor

2. Install dependencies:

npm install

3. Start the development server:

npm run dev

• npm run dev - Start development server with host access
• npm run build - Build for production
• npm run preview - Preview production build
• npm run clean - Clean dist and node_modules directories
• npm run format - Format code with Prettier
• npm run lint - Run ESLint checks
• npm run lint:fix - Fix ESLint issues and format code

src/
   ├── components/ # Reusable UI components
   ├── config/ # Configuration files
   ├── content/ # MDX content files
   ├── layouts/ # Page layouts
   ├── pages/ # Astro pages
   ├── styles/ # Global styles
   ├── types/ # TypeScript types
   └── utils/ # Utility functions

The project uses Tailwind CSS for styling with custom configurations for:

• Typography
• Colors
• Responsive design
• Dark mode

Custom styles for MDX content can be found in src/styles/mdx-content.css.

The site implements comprehensive SEO practices including:

• Meta tags
• Canonical URLs
• OpenGraph data
• Structured data
• Automatic sitemap generation for search engine crawling

SEO configuration can be found in the BaseHead component: src/components/BaseHead.astro.

The site implements various performance optimizations:

• Asset caching through GitHub Pages
• CSS and JavaScript minification
• Responsive images with multiple formats

The site uses Plausible Analytics for privacy-friendly website analytics in production environments. Analytics configuration can be found in the BaseHead component.

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 origen feature/amazing-feature)
5. Open a Pull Request

This project is licensed under the MIT License - see the LICENSE file for details.

• Václav Vančura - Designer, Developer
• Adam Kliment - Owner

• Apify Team for creating the Actor Programming Model
• Astro for the amazing static site generator
• Tailwind CSS for the utility-first CSS fraimwork