damaru / preact-www

:book: Preact documentation website.

Home Page:https://preactjs.com

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Preact Documentation Website

Build Status gitter

Based on preact-boilerplate

🚀 master is automatically deployed to preactjs.com

Application Structure

This website is built as a static-app, following the Application Shell pattern.


Content is fetched and rendered on the fly from Markdown documents located in content/. Documents can contain optional YAML FrontMatter for specifying page metadata or layout information. Once fetched, content is parsed using marked and rendered to VDOM via preact-markup.

Custom Elements

Since preact is used to render the Markdown content, HTML contained in a document reference any of the Components listed in src/components/widget.js as Custom Elements, useful for dynamic content.


Currently, the navigation menu and route handling is controlled by src/config.json. This is likely to change, but in the meantime it means any new pages must be linked from the "nav" section of the config.

Local Development

Clone & Install Dependencies

git clone https://github.com/developit/preact-www.git
cd preact-www

npm install

Development Workflow

To start a live-reload development server:

PORT=8080 npm run dev

Any time you make changes within the src directory, it will rebuild and even refresh your browser.

Generate a production build in ./build:

npm run build



ezoic increase your site revenue


:book: Preact documentation website.



Language:JavaScript 61.7%Language:CSS 36.2%Language:HTML 2.2%