From 1a494896a53b42321b089b0c40990426674f5d66 Mon Sep 17 00:00:00 2001
From: arsam <me@asabbagh.com>
Date: Fri, 18 Sep 2026 23:15:42 +0330
Subject: [PATCH] Import documentation: cshare-app/README.md

Import the existing local project snapshot. This commit organizes existing files; it does not represent newly developed functionality.
---
 cshare-app/README.md | 25 +++++++++++++++++++++++++
 1 file changed, 25 insertions(+)
 create mode 100644 cshare-app/README.md

diff --git a/cshare-app/README.md b/cshare-app/README.md
new file mode 100644
index 0000000..421a94f
--- /dev/null
+++ b/cshare-app/README.md
@@ -0,0 +1,25 @@
+# CShare Frontend
+
+React/Vite frontend for CShare.
+
+## Commands
+
+```sh
+npm install
+npm run dev
+npm run check
+npm run build
+npm run preview
+```
+
+`npm run build` emits production assets to `dist/` and precompresses them with gzip and Brotli.
+
+## Configuration
+
+Set `VITE_API_BASE_URL` when the API is hosted on a different origin:
+
+```sh
+VITE_API_BASE_URL=https://api.example.com
+```
+
+If omitted in production, the app uses same-origin API calls, which is the preferred setup behind an Nginx reverse proxy.