Publish HTML quickly. https://html.house

Matt Baer c001ce6eea Move LESS files out of `css` to `less` directory		6 years ago
keys	Add backend ability to save/get a house	8 years ago
less	Move LESS files out of `css` to `less` directory	6 years ago
main	Move import path to writeas/htmlhouse	8 years ago
static	Move LESS files out of `css` to `less` directory	6 years ago
templates	Self-host jQuery	6 years ago
.gitignore	Add package build script	7 years ago
CONTRIBUTING.md	Add contributing guidelines	6 years ago
INSTALL	Add install instructions	7 years ago
README.md	Add IRC badge to README	8 years ago
app.go	Add public houses endpoint	8 years ago
build.sh	Add install instructions	7 years ago
config.go	Support posting new public houses to Twitter	8 years ago
construction.go	Return stats with public houses	8 years ago
database.go	Add backend ability to save/get a house	8 years ago
house.go	Add backend ability to save/get a house	8 years ago
init.sql	Support posting new public houses to Twitter	8 years ago
keys.sh	Prevent running keys.sh with no params	8 years ago
makefile	Move LESS files out of `css` to `less` directory	6 years ago
models.go	Return stats with public houses	8 years ago
session.go	Fix session to work with jwt-go library v3	7 years ago
templates.go	Add Browse page	8 years ago
twitter.go	Skip tweeting pages with "HTMLhouse" title	8 years ago

README.md

HTMLhouse

Publish HTML quickly.

HTMLhouse uses ACE editor for modifying HTML and shows a live preview of what you’ve created in an iframe alongside the source code.

No user signup is required -- authorization to modify an individual published page is saved on the creator’s device in local storage as an ID and JWT generated by the server.

It is also available as a Chrome extension and browsable on Android.

Development

Requirements

Go
Node.js
MySQL

Setup

Clone the repo
Run go get -d to get necessary dependencies
Run make install to install LESS compiler locally and generate the CSS files
Run the queries in init.sql to set up the database
Optional. Run ./keys.sh prod to create a new keypair

Running the server

Run go run main/main.go in the top level directory, optionally by creating a simple run script

#!/bin/bash

DB_USER=dbuser DB_PASSWORD=pass DB_DB=htmlhouse PRIVATE_KEY=keys/dev PUBLIC_KEY=keys/dev.pub go run main/main.go

Open your browser to http://localhost:8080

Environment Variables

Variable	What it is	Default value
`DB_USER`	Database user	None. Required
`DB_PASSWORD`	Database password	None. Required
`DB_DB`	Database name	None. Required
`DB_HOST`	Database host	`localhost`
`PRIVATE_KEY`	Generated private key	None. Required
`PUBLIC_KEY`	Generated public key	None. Required
`PORT`	Port to run app on	`8080`
`STATIC_DIR`	Relative dir where static files are stored	`static`
`AUTO_APPROVE`	Automatically approves public posts	false
`TWITTER_KEY`	Twitter consumer key	`notreal`
`TWITTER_SECRET`	Twitter consumer secret	`notreal`
`TWITTER_TOKEN`	Twitter access token of the posting Twitter account	`notreal`
`TWITTER_TOKEN_SECRET`	Twitter access token secret of the posting Twitter account	`notreal`

Notes

Changing CSS. Run make after all changes to update the stylesheets.

When you don’t need to reload the app. When you make changes to any files in static/ you can simply refresh the resource without restarting the app.

When to reload the app. If you change any of the templates in templates/ or any .go file, you’ll need to re-run the app.