Update README.md

README.md

@@ -10,3 +10,44 @@ pinned: false
 ---
 
 Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+
+
+# Advanced Plate Map Designer
+
+A Streamlit app for creating detailed 24- and 96-well plate maps with multi-factor encodings (cell line, seeding density, compound, concentration, controls, etc.) and exporting high-quality PNG/SVG figures and CSV/Excel tables.
+
+## Quickstart
+
+```bash
+python -m venv .venv && source .venv/bin/activate   # or use conda/mamba
+pip install -r requirements.txt
+streamlit run plate_map_app.py
+```
+
+## Highlights
+
+- Supports **96-well (8x12)** and **24-well (4x6)** plates
+- Batch **Quick Assign** using ranges like `A1:A6, B1:B3, D5`
+- **Serial Dilution Wizard** and **Seeding Gradient** tools
+- Encode wells by **compound**, **cell line**, **controls**, **concentration**, **seeding density**
+- Optional **text overlay** per well: concentration, cells/well, notes, replicate, etc.
+- **Edge-well highlighting** and one-click **edge buffer/blank** marking
+- **Import** existing maps from CSV/Excel (must include a `well` column)
+- **Export** plate table to **CSV/Excel** and **figure** to **PNG/SVG** (vector, publication-ready)
+- Legends for numeric and categorical encodings
+
+## Tips
+
+- Choose `Color wells by → concentration` to see a continuous colorbar; select `compound` or `cell_line` for categorical palettes.
+- The small **center dot** color encodes `cell_color` (set via Quick Assign).
+- Use the **SVG export** for Illustrator/Inkscape editing.
+
+## Table Schema (columns)
+
+`well,row,col,cell_line,cell_color,seeding_density,compound,compound_color,concentration,conc_units,vehicle,control_type,timepoint,replicate,group_id,notes`
+
+You can add extra columns when importing; they will be kept and saved on export.
+
+---
+
+Made by ChatGPT.