glsl-sandbox

Server development

Setup

Fork repository
Download repository and create new development branch:

$ git clone git@github.com:<your user>/glsl-sandbox
$ cd glsl-sandbox
$ git checkout -b <feature name>

Download and uncompress test data:

$ curl -O https://downloads.zooloo.org/glslsandbox-data.tar.gz
$ tar xvf glslsandbox-data.tar.gz

Build server binary needs go compiler:

$ go build ./server/cmd/glslsandbox

Alternatively you can download and uncompress the binary in the repository directory from https://github.com/mrdoob/glsl-sandbox/releases/latest
Run server:

$ ./glslsandbox

The first time it starts it creates an admin user and the credentials are printed.
The server should be accessible on http://localhost:8888
Admin interface is on http://localhost:8888/admin

Template and javascript modifications

The server reloads templates and assets on each query. This eases the development as you can modify the files and changes will take effect reloading the page.

There’s only one template that is used for both the gallery (index) and admin page. The file is server/assets/gallery.html and uses go language templates. You can find more information about its syntax here:

Currently the page receives this data:

// galleryEffect has information about each effect displayed in the gallery.
type galleryEffect struct {
    // ID is the effect identifyier.
    ID int
    // Version is the latest effect version.
    Version int
    // Image holds the thumbnail name.
    Image string
    // Hidden tells if the effect has been moderated.
    Hidden bool
}
// galleryData has information about the current gallery page.
type galleryData struct {
    // Effects is an array with all the effects for the page.
    Effects []galleryEffect
    // URL is the path of the gallery. Can be "/" or "/admin".
    URL string
    // Page holds the current page number.
    Page int
    // IsPrevious is true if there is a previous page.
    IsPrevious bool
    // PreviousPage is the previous page number.
    PreviousPage int
    // IsNext is true if there is a next page.
    IsNext bool
    // NextPage is the next page number.
    NextPage int
    // Admin is true when accessing "/admin" path.
    Admin bool
}

This is, galleryData for the page and galleryEffect for each effect. For example, to print all the effect IDs you can use:

<ul>
{{ range .Effects }}
    <li>{{ .ID }}</li>
{{ end }}
<ul>

The following directories are accessible from the server and can be modified if needed:

server/assets/css -> /css
server/assets/js -> /js

By default the data files are read from ./data. This path can be hanged with the environment variable DATA_PATH. For example:

$ DATA_PATH=/my/data/directory ./glslsandbox

The data directory contains the sqlite database (glslsandbox.db) and the thumbnails (thumbs directory).