This repo contains the source code and content of my blog & wiki website at stevium.com.
It is a fork of masochist by wincent containing overrides and modifications needed for customized view layer and content management, intended to enable emacs org and typescript support.
Content is authored in plain-text-friendly markup formats like Markdown and
served using a dynamic stack (described below). New code can be deployed and
content added or updated via git push.
- React: Declarative, component-oriented view layer.
- Relay: Declarative data-management.
- GraphQL: Hierarchical data querying language, type system and server.
- Git: Main content storage.
- Redis: Indexing and caching.
- memcached: Ephemeral caching.
brew install git memcached redis
git clone https://github.com/stevium/stevium.git
cd stevium
yarn
yarn update-schema
yarn update-indices # Whenever content changes.
yarn start
yarn run build # Builds files under `dist/`.
yarn start-prod
export NODE_ENV=production
yarn
yarn build
node dist/bin/updateIndices.js # Whenever content changes.
node dist/server/main.js
In __DEV__, Stevium will look for content in the current repo (ie. .).
In production, it expects to find a content repo at /srv/stevium/content.
In __DEV__, you can override this with npm config set. For example, in my local development environment, I have the Stevium Git repo checked out in one folder, and a second copy of it with the content branch checked out within it (using git-worktree) at ./content (see below for more details on this set-up). I can override the __DEV__ default of . with:
# Use npm, not yarn, for this:
npm config set masochist:content-repo './content'
You could do this in any number of ways but the way I'm doing it is using two local repositories as follows:
mainbranch checked out.githubremote pointing at GitHub.steviumremote set up to do Heroku-style deploy-on-push, pointing at an Amazon EC2 instance configured using Ansible.contentremote set up to do a Heroku-style update-on-push for content changes, pointing at the corresponding repository on EC2.
$ git push stevium main # Deploy app (after initial provisioning).
$ git push stevium # Subsequent deployments.
$ git push origin # Propagate code, but no deploy.
$ git push # Shorthand for `git push origin`.
$ git push github # If you can't be bothered waiting for it to auto-replicate.
contentbranch checked out.contentremote configured to do Heroku-style push-to-publish.originremote pointing at git.stevium.com.githubremote pointing at GitHub.
$ git push content content # First push after initial provisioning.
$ git push content # Subsequent pushes.
$ git config branch.content.merge refs/heads/content # For laziness.
$ git push # Simple.
$ git push stevium +$HASH:main
Or just switch symlinks and sudo monit restart stevium.
$ git commit -m Deploy --allow-empty
$ git push stevium
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent