Skip to content
Website about building on the Decentralised Web that lives on the Web and the DWeb (SAFE Network)
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
content
public
scripts
src
.babelrc
.eslintrc.js
.gitignore
LICENSE
README.md
package.json
static.config.js
yarn.lock

README.md

dWeb Blog - a Website for both Web and Decentralised Web

dWeb Blog is a blazing fast website that you can deploy to both the Web and decenralised Web (dWeb) in a single command. The code is open source (GPL3), so everything here is free to use and build on.

dWeb combines the advanced features from ReactJs for website design and development, with React-static's blazing fast, optimised website with just-in-time preloading.

This website's purpose is to show you how to do everything it does, and to provide a live tutorial for website development by documenting its evolution from capable demo and starting point for a pro website, to fully fledged CMS. Along the way it will also show other things I'm working on, such as SAFE Drive, decentralised Git, and of course Solid.

With some help, this project can be developed into a full featured Wordpress style CMS, combining the interoperability and analytical capabilities of Solid with the security, privacy and freedom of SAFE Network, and bridge the transition from the increasingly centralised web, to the a more robust user oriented decentralised web.

Current Status

dWeb already works so you can visit it live on web and SAFE Network (see below) as well as use it as the basis for your own website. Posts and content are created in markdown, and automatically uploaded to the Web and to SAFE Network with a single command.

Code and content versioning and backup are easily maintained under git. My intention is to build on this base to work with local headless CMS or cloud CMS, and other data types such as RDFa (Linked Data).

Workflow:

  1. Create and edit markdown files under ./content

If you build on dWeb Blog yourself, you can help build the future by submitting your enhancements in the form of pull requests via github/dweb-blog (owned by Microsoft) or safe://dweb.dgit via SAFE Drive/safegit (owned by us). The latter is still in alpha, so for the time being both will be kept in sync.

dWeb is itself a fork of rs-blog-demo (shh, don't tell github), my playground for learning about React-static, and a live example of building blazing fast websites on web and dWeb (SAFE Network). Some enhancements to dWeb will no doubt make it back into rs-blog-demo, which will remain a cleaner more basic starting point, but likely some way behind dWeb Blog. So for now best to fork dWeb Blog and start here.

Quick Start

Development

React-static uses yarn so if you don't have it, install without npm from yarnpkg.com or using npm with:

$ npm install -g yarn

Install React-static:

$ yarn global add react-static

Get dWeb and run the development server.

git clone https://github.com/theWebalyst/dweb-blog && \
cd dweb-blog && \
yarn  && \
yarn start

Visit http://localhost:3000 and start adding content (see below), or editing the code if you want to modify the look and feel, styles, colours and so on. See the React-static documention for how to customise the website code.

Test a production build

yarn stage
yarn serve # at http://localhost:3000

Deploy Website

Build for production (output in ./dist):

yarn build

Upload the contents of ./dist to your website's root HTML directory on the web or SAFE Network.

Automated Deployment to Web

To automate build and upload by ftp, see the bash script ./script/deployweb.sh

Automated Deployment to SAFE Network

You can upload the contents of your website from ./dist to SAFE Network using a suitable application such as the Maidsafe Web Hosting Manager, or if you are using SAFE Drive, on Linux you can upload the website on SAFE Network as follows.

  • Start SAFE Drive and connect to SAFE Network so that your SAFE Drive is mounted at ~/SAFE

  • Execute the following command, substituting the destination path of your website storage on SAFE Network. Note the trailing '/' on both source and destination paths.

   cp -ruv ./dist/ ~/SAFE/_public/dweb/www-root/

There's script to automate this (scripts/deployweb.sh) which you can customise to upload both to web and SAFE in one command.

Website Content

Create content as markdown files under /content. Later content will be derived from other sources such as Solid Linked Data (Turtle files) via LDP on clearweb or SAFE Network.

Origin

Fork of rs-blog-demo.

LICENSE

  • Website content is Copyright (C) Mark Hughes 2019. All Rights Reserved.
  • Everything else is GPL3.0

'Content' includes everything under ./content and ./public.

You can’t perform that action at this time.