docs: update README to clarify project structure and deployment process

Signed-off-by: Daniel Ntege <danientege785@gmail.com>

Author: danielmarv

README.md

@@ -1,10 +1,10 @@
 # Open Elements Website
 
-This repository contains the Open Elements website.
+This repository contains the Open Elements website built with Next.js and Tailwind CSS, with legacy Hugo content kept for migration and historical content.
 
 ## Architecture (2026)
 
-The project is now a Next.js application with App Router, Tailwind CSS, and `next-intl` for i18n. Legacy Hugo content and templates are still kept in the repo for migration and historical content.
+The project is a Next.js application using App Router, Tailwind CSS, and `next-intl` for i18n. Legacy Hugo content and templates are kept in the repo for migration and historical content.
 
 ### Runtime layers
 
@@ -58,8 +58,36 @@ pnpm run build
 pnpm run start
 ```
 
+### Lint
+
+```
+pnpm run lint
+```
+
 ### E2E tests
 
 ```
 pnpm run test:e2e
 ```
+
+## Repo structure
+
+```
+src/app            Next.js App Router pages & layouts
+src/components     UI components
+src/i18n           next-intl routing/messages helpers
+locales            Translation JSON files
+content            Legacy Hugo Markdown content
+src/layouts        Legacy Hugo templates
+public             Static assets and generated artifacts
+react-src          Web components source (bundled to public/js)
+tests/e2e          Playwright specs
+```
+
+## Web components build
+
+Custom elements in `react-src` are bundled with esbuild via `react-src/build.mjs` into `public/js`. This output is treated as generated code.
+
+## Deployment
+
+Netlify builds run `pnpm install` and `pnpm run build` (see `netlify.toml`).