diff --git a/README.md b/README.md index 10f5c2a..a3680c2 100644 --- a/README.md +++ b/README.md @@ -1 +1,77 @@ # pyinfra.com + +The official website for [pyinfra](https://github.com/pyinfra-dev/pyinfra) - a fast, Python-based infrastructure automation and configuration management tool. + + +## 📂 Project Structure + +``` +pyinfra.com/ +├── index.html # Main landing page +├── static/ +│ ├── pyinfra.css # Custom styles +│ ├── github.css # GitHub markdown styles +│ └── fonts/ # Custom web fonts +└── README.md # This file +``` + +## 🎨 Website Overview + +This is a static HTML website designed with modern web standards in mind: + +### SEO Optimization +- **Comprehensive meta tags** - Title, description, keywords optimized for search engines +- **Structured data (JSON-LD)** - Rich snippets for better search visibility +- **Open Graph tags** - Optimized social media sharing for Facebook/LinkedIn +- **Twitter Card tags** - Enhanced Twitter sharing experience +- **Semantic HTML** - Proper heading hierarchy and ARIA labels +- **Mobile-first responsive design** - Optimized for all device sizes + +### Design Features +- **Modern visual elements** - Gradient backgrounds, smooth transitions, hover effects +- **Accessibility** - ARIA labels, semantic HTML, keyboard navigation support +- **Performance optimized** - Preconnect hints, async loading, efficient CSS +- **Professional typography** - Roboto Slab font for headings +- **Color scheme** - Clean green gradient matching the pyinfra brand + +### Technical SEO +- **Fast loading times** - Minimal dependencies, optimized assets +- **Mobile-friendly** - Responsive design with proper viewport configuration +- **Clean URL structure** - Canonical URLs and proper redirects +- **Analytics integration** - Privacy-focused analytics via Plausible + +## 🔧 Development + +### Local Testing + +Simply open `index.html` in a web browser, or use a local server: + +```bash +# Python 3 +python -m http.server 8000 +``` + +Then navigate to `http://localhost:8000` + +### Making Changes + +1. **HTML content** - Edit `index.html` for content updates +2. **Styles** - Modify `static/pyinfra.css` for design changes +3. **Test locally** - Always test changes in a browser before deploying +4. **SEO updates** - Update meta tags when changing page content + +## 🔗 Links + +- **Documentation**: [docs.pyinfra.com](https://docs.pyinfra.com) +- **GitHub Repository**: [github.com/pyinfra-dev/pyinfra](https://github.com/pyinfra-dev/pyinfra) +- **Examples**: [github.com/pyinfra-dev/pyinfra-examples](https://github.com/pyinfra-dev/pyinfra-examples) +- **Community Chat**: [Matrix](https://matrix.to/#/#pyinfra:matrix.org) + +## 🤝 Contributing + +To suggest improvements to the website: + +1. Fork the repository +2. Make your changes +3. Test thoroughly (check responsiveness, SEO, accessibility) +4. Submit a pull request with a clear description diff --git a/index.html b/index.html index 85a9880..366ef5a 100644 --- a/index.html +++ b/index.html @@ -1,6 +1,6 @@ - - pyinfra turns Python code into shell commands and runs them on your servers + + pyinfra - Fast Python Infrastructure Automation & Configuration Management Tool @@ -8,28 +8,78 @@ - - + + + + + - - + + + + + + + + + + + + + + + + + + + + +
-

- -

-
@@ -38,38 +88,260 @@

-

pyinfra turns Python code into shell commands and runs them on your servers. Execute ad-hoc commands and write declarative operations. Target SSH servers, local machine and Docker containers. Fast and scales from one server to thousands.

-

Think ansible but Python instead of YAML, and a lot faster.

+

pyinfra - Python Infrastructure Automation

+

pyinfra turns Python code into shell commands and runs them on your servers. Execute ad-hoc commands and write declarative operations. Target SSH servers, local machine and Docker containers. Fast and scales from one server to thousands.

+

Think ansible but Python instead of YAML, and up to 10x faster.

+ +
+
+
10x
+
Faster than Ansible
+
+
+
4.4k+
+
GitHub Stars
+
+
+
100%
+
Python
+
+
+
0
+
Agent Dependencies
+
+
+

Why Choose pyinfra?

    -
  • 🚀 Super fast execution over thousands of targets with predictable performance. Up to 10x faster than Ansible.
  • -
  • 🚨 Instant debugging with realtime output from shell commands being executed and no abstraction layer.
  • -
  • 🔄 Declarative operations that only make changes when needed and enable diff checking.
  • -
  • 📦 Extendable with the entire Python package ecosystem. Inventory and operations are written in Python.
  • -
  • 💻 Agentless execution against anything with POSIXish shell access, no dependencies on targets.
  • -
  • 🔌 Integrated with other tools. Pull inventory from Terraform, execute against Docker containers.
  • +
  • Super Fast Execution — Deploy to thousands of targets with predictable performance. Up to 10x faster than Ansible.
  • +
  • Instant Debugging — Get realtime output from shell commands with no abstraction layer for immediate troubleshooting.
  • +
  • Declarative Operations — Only make changes when needed with built-in diff checking and idempotent operations.
  • +
  • Fully Extendable — Leverage the entire Python package ecosystem. Write inventory and operations in pure Python.
  • +
  • Agentless Architecture — Deploy to any system with POSIX shell access. Zero dependencies on target systems.
  • +
  • Seamless Integration — Pull inventory from Terraform, execute against Docker containers, integrate with your DevOps toolchain.
-
- Getting Started - Examples Repo -