From 8cfc4e4fc24973ed106c1573cb43808abbebbecb Mon Sep 17 00:00:00 2001
From: Arnaud Delcasse <arnaud.delcasse@mobicoop.org>
Date: Tue, 30 Dec 2025 12:30:54 +0100
Subject: [PATCH] Add README

---
 README.md | 68 +++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 68 insertions(+)
 create mode 100644 README.md

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..87aef8a
--- /dev/null
+++ b/README.md
@@ -0,0 +1,68 @@
+# MMS43 - Maison de la Mobilité Solidaire Haute-Loire
+
+This repository contains the website for **MMS43** (Maison de la Mobilité Solidaire Haute-Loire), a solidarity mobility service in the Haute-Loire department of France.
+
+## About MMS43
+
+MMS43 is an organization that provides accessible mobility solutions for people who face transportation challenges. The platform offers a range of services to help individuals gain or maintain their mobility independence.
+
+### Mobility Solutions
+
+- **Transport Solidaire** - Solidarity transport services
+- **Accompagnement Mobilité** - Mobility coaching and support
+- **Location de Véhicules** - Vehicle rental services
+- **Garage Solidaire** - Solidarity garage (affordable vehicle maintenance)
+- **Auto-école Solidaire** - Solidarity driving school
+- **Vélo-école** - Bicycle training school
+
+## Technology Stack
+
+- **Static Site Generator**: [Hugo](https://gohugo.io/)
+- **Theme**: Custom theme (`mms43`)
+- **Styling**: CSS with CSS variables for theming
+- **Font**: Quicksand (Google Fonts)
+
+## Project Structure
+
+```
+mms43/
+├── content/           # Page content (Markdown files)
+│   └── pages/         # Site pages
+├── themes/mms43/      # Custom Hugo theme
+│   ├── assets/        # CSS, images, videos
+│   ├── layouts/       # Hugo templates
+│   └── static/        # Static files
+└── hugo.yaml          # Hugo configuration
+```
+
+## Features
+
+- Responsive design (desktop, tablet, mobile)
+- Dynamic contact forms with configurable fields
+- Video integration
+- Partner logos showcase
+- Accessible navigation with mobile menu
+
+## Development
+
+### Prerequisites
+
+- Hugo (extended version recommended)
+
+### Running locally
+
+```bash
+hugo server -D
+```
+
+### Building for production
+
+```bash
+hugo --minify
+```
+
+## License
+
+This project is licensed under the **AGPLv3** (GNU Affero General Public License v3.0).
+
+Brand elements (logos, trademarks, visual identity) are the property of **Maison de la Mobilité Solidaire de Haute-Loire** and are not covered by the open-source license.