Skip to content
dropbox based blog engine, written in go.
Branch: master
Clone or download

Latest commit

Fetching latest commit…
Cannot retrieve the latest commit at this time.


Type Name Latest commit message Commit time
Failed to load latest commit information.
Godeps upgrage to go 1.6 and migrate godeps to ./vendor Apr 23, 2016
datastore add article summary Mar 17, 2015
dropbox uses smart update system Feb 22, 2015
static use hide as default theme Apr 15, 2015
templates adds auxiliary css class to the body Apr 24, 2015
vendor upgrage to go 1.6 and migrate godeps to ./vendor Apr 23, 2016
.env.sample updates readme Apr 22, 2015
.gitignore changes gitignore Apr 22, 2015
LICENSE Update Aug 9, 2018
cli.go creates images dir Apr 22, 2015
config.go cleaned up a bit Apr 14, 2015
main.go move templates initialization in main func Apr 26, 2015
oauth_handlers.go cleaned up a bit Apr 14, 2015
template.go move templates initialization in main func Apr 26, 2015



A Dropbox based blog engine

This project started as a blog as a service platform, but it quickly ended up to be my personal blog. It does its job, it's far away to be pretty and polished but you maybe find it useful. It allows you to manage your blog in markdown format from your dropbox folder.

You can run it on your machine without installing anything, It's all bundled in the executable (html and css too), and it saves the data in a bolt database. It's performance wise too, my personal blog is served by a raspberry pi behind my crappy DSL router.

Try it

If you want to try it without compile it by yourself you can grab the executable from the aplha releases page

You have to create a dropbox app and select the following:

then you need to modify the .env.sample file accordingly and in your terminal:

# set env variables
source .env.sample

# link local app to dropbox (follow the instructions)
./boxed --oauth

# put a markdown file in the published folder in your dropbox directory and publish it with:
./boxed --refresh

#run the server with

# visit localhost:8080 to see the result 

if you have correctly set the webhook path you don't need to refresh, it will be published when the article will been synchronized to your dropbox.

Articles metadata

Boxed will try its best to figure out the publication date and title from the markdown article. If this is not enough for you, you can specify some metadata with a markdown/json comment like this:

		"created-at": "2013-11-11",
		"permalink": "a-brand-new-blog",
		"title": "A brand new blog"


Boxed supports images out of the box, you have to put them in the images folder, and then reference them like: ![cool image](../images/image.jpeg "Cool image")

Template customization

Boxed comes with the excellent default hyde template. If you want to change it, like i did it for my blog, you have to be able to compile go code, then you have to change the template/css files and then use go rice to bundle them back in the executable.

Future versions will allow to customize the look and feel directly from the dropbox folder.


You can run boxed tests with:

go test ./...


This project is licensed under a Simplified BSD license. Please read the LICENSE file.

TODO & Development

  • make onboarding easier
  • allow look and feel customization from dropbox folder without requiring code compilation.
  • add tests for the http flow
  • blog live updates with SSE or websockets
  • allow articles to be published in the future
You can’t perform that action at this time.