Refresh README with screenshots and license Daymark under GPL-3.0

README.md

@@ -1,35 +1,133 @@
+<div align="center">
+
 # Daymark
 
-A self-hosted, multi-user diary for days, places, people, and ideas.
+**Your days, in your own words.**
 
-Daymark combines Markdown journaling, photos and media, maps, calendar and timeline views, search, sharing, account exports, and administration. It includes password authentication, TOTP, passkeys, and an installable web app.
+A self-hosted diary for memories, places, people, and ideas.
 
-## Run with Docker
+[![License: GPL v3](https://img.shields.io/badge/License-GPLv3-blue.svg)](LICENSE)
+[![Self-hosted](https://img.shields.io/badge/Self--hosted-Docker-2496ED?logo=docker&logoColor=white)](#quick-start)
 
-1. Copy `.env.example` to `.env`.
-2. Set three different strong random secrets in `.env`.
-3. Run `docker compose up -d --build`.
-4. Open `http://localhost:3000` and create your first account.
+[Get started](#quick-start) · [Screenshots](#screenshots) · [Deployment guide](DEPLOYMENT.md) · [Changelog](CHANGELOG.md)
 
-The first account becomes administrator. The included Mailpit development inbox is available on port 8025. Configure production email and HTTPS before making an installation available online; set `COOKIE_SECURE` to `true` behind HTTPS.
+</div>
 
-PostgreSQL, media storage, mail, and backups use Compose-project-scoped volumes. Use a distinct project name for every installation. Never point a test or public instance at another installation's database or volumes.
+![Daymark diary view with dated entries, topics, and search](docs/screenshots/daymark-diary.png)
 
-`docker-compose.standalone.yml` is an equivalent portable configuration. See [deployment instructions](DEPLOYMENT.md).
+Daymark gives you a place to write, collect photos and recordings, and revisit the moments that matter. Run it on your own server, keep entries private, or share selected memories with others.
+
+## What you can do
+
+| | Features |
+| --- | --- |
+| **Write** | Markdown, drafts, writing prompts, templates, and entry revision history. |
+| **Collect** | Photos, video, audio, documents, voice notes, and links alongside your writing. |
+| **Rediscover** | Search, tags, journals, calendar, timeline, gallery, maps, and statistics. |
+| **Share** | Multiple accounts, shared journals, comments, and expiring sharing links. |
+| **Protect** | Private entries, optional text encryption, two-factor authentication, and passkeys. |
+| **Take it with you** | An installable web app, offline drafts, exports, and backups. |
+
+## Screenshots
+
+Screenshots show the real interface with fictional sample entries.
+
+### A timeline of your days
+
+Browse your journal chronologically and jump back into a memory.
+
+![Daymark timeline showing journal entries in date order](docs/screenshots/daymark-timeline.png)
+
+### Space to write
+
+Format your entry, choose its date, and add tags, media, or a location.
+
+![Daymark entry editor with formatting tools and sample writing](docs/screenshots/daymark-editor.png)
+
+## Quick start
+
+**You need:** Docker Engine with Docker Compose, or Docker Desktop.
+
+### 1. Get Daymark
+
+```sh
+git clone https://github.com/donishki/Daymark.git
+cd Daymark
+```
+
+You can also clone from [Gitea](https://git.ptbox.org/dasp/Daymark).
+
+### 2. Set your secrets
+
+Copy `.env.example` to `.env`:
+
+```sh
+cp .env.example .env
+```
+
+On Windows PowerShell, use `Copy-Item .env.example .env`.
+
+Open `.env` in a text editor and fill in all three values with **different, strong random secrets**:
+
+```dotenv
+DB_PASSWORD=
+MINIO_PASSWORD=
+AUTH_ENCRYPTION_KEY=
+```
+
+Keep this file safe. You will need the same values when restoring your installation.
+
+### 3. Start the app
+
+```sh
+docker compose up -d --build
+```
+
+Open **[localhost:3000](http://localhost:3000)** and create your account. The first account becomes the administrator.
+
+Installing on another machine? Replace `localhost` with that server's address.
+
+> **Before going online:** configure HTTPS, set `COOKIE_SECURE` to `true`, and configure production email delivery. The included Mailpit inbox at port `8025` is for testing. See the [deployment guide](DEPLOYMENT.md) for Portainer, configuration, and backups.
+
+## Everyday commands
+
+```sh
+# Check service status
+docker compose ps
+
+# View application logs
+docker compose logs -f diary
+
+# Stop the services while keeping your data
+docker compose down
+```
+
+For updates, back up your data first, then pull the latest code and rebuild:
+
+```sh
+git pull --ff-only
+docker compose up -d --build
+```
 
 ## Development
 
-Use Node.js 22 or later. Run `npm ci` and `npm run build` to build the frontend. `npm run dev` starts Vite; the backend requires the database and storage configuration supplied by Docker Compose.
+Use **Node.js 22.12+**.
 
-## Repositories
+```sh
+npm ci
+npm run dev
+```
 
-- [GitHub](https://github.com/donishki/Daymark)
-- [Gitea](https://git.ptbox.org/dasp/Daymark)
+The API requires PostgreSQL, MinIO, and the environment settings described in the [deployment guide](DEPLOYMENT.md). Use Docker Compose for a complete local stack.
 
-This public edition starts with clean source history. Personal deployment configuration and diary contents are excluded. Database and media content live in deployment volumes, not this source repository.
+Build the frontend with `npm run build`.
 
-Legacy storage keys and export identifiers are retained for compatibility with existing backups.
+## Links
+
+[GitHub](https://github.com/donishki/Daymark) · [Gitea](https://git.ptbox.org/dasp/Daymark) · [Report an issue](https://github.com/donishki/Daymark/issues) · [Planned improvements](TODO.md)
 
 ## License
 
-No open-source license has been selected. All rights reserved until a license is added.
+Copyright © 2026 Dario P.
+
+Daymark is licensed under the **GNU General Public License v3.0** (`GPL-3.0-only`). See [LICENSE](LICENSE) for the full terms.