docs: update readme

Author: megasanjay

.github/workflows/semantic-release.yml

@@ -1,13 +1,40 @@
 <div align="center">
 
-<h1>posters.science Documentation</h1>
+<img src="https://cdn.posters.science/logos/poster-fairy.png" alt="Posters.science logo" title="This image was generated by AI" width="200" height="auto" />
+
+<br />
+
+<h1>Posters.science</h1>
+
+<p>
+A free, open-source platform for sharing, discovering, and citing scientific posters.
+</p>
+
+<br />
 
 <p>
-Documentation for posters.science.
+  <a href="https://github.com/fairdataihub/posters-science/graphs/contributors">
+    <img src="https://img.shields.io/github/contributors/fairdataihub/posters-science.svg?style=flat-square" alt="contributors" />
+  </a>
+  <a href="https://github.com/fairdataihub/posters-science/stargazers">
+    <img src="https://img.shields.io/github/stars/fairdataihub/posters-science.svg?style=flat-square" alt="stars" />
+  </a>
+  <a href="https://github.com/fairdataihub/posters-science/issues/">
+    <img src="https://img.shields.io/github/issues/fairdataihub/posters-science.svg?style=flat-square" alt="open issues" />
+  </a>
+  <a href="https://github.com/fairdataihub/posters-science/blob/main/LICENSE">
+    <img src="https://img.shields.io/github/license/fairdataihub/posters-science.svg?style=flat-square" alt="license" />
+  </a>
 </p>
 
 <h4>
-  <a href="https://github.com/fairdataihub/posters-science-docs/issues/">Report Issues/Make suggestions</a>
+    <a href="https://posters.science">Website</a>
+  <span> · </span>
+    <a href="https://dev.posters.science">Developer Docs</a>
+  <span> · </span>
+    <a href="https://github.com/fairdataihub/posters-science/issues/">Report Bug</a>
+  <span> · </span>
+    <a href="https://github.com/fairdataihub/posters-science/issues/">Request Feature</a>
 </h4>
 </div>
 
@@ -17,32 +44,33 @@ Documentation for posters.science.
 
 ## About
 
-This repository contains the documentation for posters.science.
+Posters.science is a platform for researchers to upload, share, and discover scientific conference posters. When a poster is uploaded, the platform automatically extracts structured metadata such as titles, authors, affiliations, sections, and figure captions. This makes posters findable, citable, and machine-readable.
 
-## Developer Instructions
+The platform is built around [FAIR principles](https://www.go-fair.org/fair-principles/) (Findable, Accessible, Interoperable, Reusable) and integrates with [Zenodo](https://zenodo.org/) so that posters can be deposited with a DOI for long-term archival and citation.
 
-### Prerequisites
+Posters.science is developed by the [FAIR Data Innovations Hub](https://fairdataihub.org/) at the [California Medical Innovations Institute (CalMI2)](https://calmi2.org/).
 
-This project uses `yarn` as the package manager.
+## Getting Started
 
-```bash
-npm install -g yarn
-```
-
-### Run Locally
+**Prerequisites:** Mise to handle the node and pnpm installation.
 
 ```bash
-git clone https://github.com/fairdataihub/posters-science-docs.git
-cd posters-science-docs
-yarn install
-yarn dev
+mise trust # only needed the first time to trust this repository
+mise install
+
+pnpm install
+pnpm dev
 ```
 
-### Build Locally
+The site will be available at `http://localhost:3000`.
 
-```bash
-yarn docs:build
-```
+## Scripts
+
+| Command             | Description              |
+| ------------------- | ------------------------ |
+| `pnpm dev`          | Start local dev server   |
+| `pnpm docs:build`   | Build for production     |
+| `pnpm docs:preview` | Preview production build |
 
 ## License