# GitCart

<div align="center">

**Universal static e-shop generator from markdown files**

[Documentation](#documentation) • [Quick Start](#quick-start) • [Features](#features) • [Plugins](#plugins) • [Contributing](#contributing)

</div>

---

## 🎯 What is GitCart?

GitCart is a modern, lightweight static e-commerce website generator that creates fast and SEO-optimized e-shops from simple markdown files and JSON configuration. Perfect for small to medium e-shops that don't need complex CMS but want professional and fast solutions.

### ✨ Key Features

- 📁 **Simple structure** - Products and categories in markdown files
- 🌍 **Multilingual support** - Full support for multiple languages and locales
- 🎨 **Flexible templating** - Liquid templates with customization options
- 🔍 **SEO optimized** - Automatic sitemaps, meta tags, structured data
- 🛒 **E-commerce features** - Cart, checkout, product filters
- 🔌 **Plugin system** - Extensibility through JavaScript plugins
- 📱 **Responsive design** - Mobile-first approach with Tailwind CSS
- ⚡ **Fast results** - Static files for maximum speed
- 🚀 **Easy deployment** - GitHub/GitLab Pages, Netlify, Vercel ready

## 🚀 Quick Start

### Installation

#### Recommended: Global Installation
```bash
npm install -g gitcart-cli
```

#### Alternative: Local Installation with npx
```bash
npm install gitcart-cli
# Then use with npx:
npx gitcart init my-eshop
```

### Creating a New Project

```bash
# With global installation
gitcart init my-eshop

# With local installation
npx gitcart init my-eshop

# With default template
gitcart init my-eshop --template default

# With minimal template
gitcart init my-eshop --template minimal
```

## 📚 Documentation

Choose your preferred language for complete documentation:

### 🇺🇸 English Documentation
**[📖 Complete English Documentation](docs/en-us/README.md)**

- [📖 User Guide](docs/en-us/user-guide.md) - Complete guide to using GitCart
- [⚙️ Configuration](docs/en-us/configuration.md) - Detailed configuration reference
- [🎨 Template System](docs/en-us/templates.md) - Creating custom templates
- [🔌 Plugin Development](docs/en-us/plugin-api.md) - Plugin API reference
- [🌍 Multilingual Support](docs/en-us/multilingual.md) - Creating multilingual e-shops

### 🇨🇿 Czech Documentation
**[📖 Complete Czech Documentation](docs/cs-cz/README.md)**

- [📖 User Guide](docs/cs-cz/user-guide.md) - Complete guide to using GitCart
- [⚙️ Configuration](docs/cs-cz/configuration.md) - Detailed configuration reference
- [🎨 Template System](docs/cs-cz/templates.md) - Creating custom templates
- [🔌 Plugin Development](docs/cs-cz/plugin-api.md) - Plugin API reference
- [🌍 Multilingual Support](docs/cs-cz/multilingual.md) - Creating multilingual e-shops
