Adds ushahidi app.

ushahidi/versions/5/README.md

@@ -0,0 +1,35 @@
+# Ushahidi
+
+Ushahidi is a crisis mapping and crowdsourcing platform for collecting, visualising, and analysing reports from a community.
+
+## Dependencies
+
+- **MySQL** - Database for storing posts, surveys, and users
+- **Redis** - Used for caching and background job queuing
+
+## Configuration
+
+Key settings in `config.yaml`:
+
+- **domain** - Where the Ushahidi web client will be accessible
+- **apiDomain** - Where the Ushahidi API is accessible (default: `ushahidi-api.{your-cloud-domain}`)
+- **storage** - Persistent volume size (default: `2Gi`)
+- **db.name** - Database name (default: `ushahidi`)
+
+## First-Time Setup
+
+1. Add and deploy the app:
+   ```bash
+   wild app add ushahidi
+   wild app deploy ushahidi
+   ```
+
+2. Visit the client URL and complete the setup wizard to create your admin account and configure your deployment.
+
+3. Start creating surveys and collecting reports from the public.
+
+## Notes
+
+- Ushahidi has two components: the **API** (Laravel) and the **Client** (Angular) — both are deployed together and served on separate domains
+- The Laravel API has a slow startup (~2 minutes) due to framework initialization — the deployment uses extended liveness probe delays to prevent restart loops
+- The `appKey` is auto-generated in `secrets.yaml` and used for Laravel encryption