The new Ripple frontend.
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Giuseppe Guerra 3fc0620d69 Merge branch 'master' of zxq.co:ripple/hanayo 3 달 전
data Ranking criteria fixes 4 달 전
modules Updated hardcoded server ips 6 달 전
routers Bancho API privs, Bancho OAuth, update api vendor 4 달 전
scripts Update locales 1 년 전
semantic Fix placeholder color being completely white 2 년 전
services Finish token creation pages 2 년 전
static Bancho API privs, Bancho OAuth, update api vendor 4 달 전
templates Ranking criteria fixes 4 달 전
vendor Bancho API privs, Bancho OAuth, update api vendor 4 달 전
website-docs @ 1bd4238f62 Updated submodule website-docs 3 달 전
.drone.yml add drone 1 년 전
.editorconfig add drone 1 년 전
.eslintrc eslint config 1 년 전
.gitignore Add basic oauth flow 2 년 전
.gitmodules Add submodule website-docs 2 년 전
2fa.go append query to redir URL in 2fa 2 년 전
Gopkg.lock Bancho API privs, Bancho OAuth, update api vendor 4 달 전
Gopkg.toml require license to be agreed before starting hanayo 1 년 전
LICENSE Forgetting we are using GNU AGPL: check 3 년 전
README.md Explain why you shouldn't write code like hanayo in the README 1 년 전
avatar.go ADD EVERYTHING TO TEMPLATES FILE OH YEAH 2 년 전
beatmap.go merge appends and remove shiet 1 년 전
context.go fix breaking changes 1 년 전
dev.go Bancho API privs, Bancho OAuth, update api vendor 4 달 전
doc.go ⬆️ v1.8.6 ⬆️ 1 년 전
errors.go ADD EVERYTHING TO TEMPLATES FILE OH YEAH 2 년 전
funcmap.go Play Time 6 달 전
gulpfile.js make dark site a real setting instead of an easter egg 1 년 전
helpers.go pass valid context to Exchange code 1 년 전
irc.go ADD EVERYTHING TO TEMPLATES FILE OH YEAH 2 년 전
loadchangelog.go Support for new changelog format 11 달 전
localisation.go Make website show localised text 2 년 전
login.go ADD EVERYTHING TO TEMPLATES FILE OH YEAH 2 년 전
main.go require license to be agreed before starting hanayo 1 년 전
messages.go Add messages system (for {error,success,info,...} messages) 3 년 전
oauth.go Add X-Frame-Options: deny to OAuth token requests 2 년 전
package.json Start implementing localisation in JavaScript 2 년 전
profbackground.go Slight increase of 13% of profile background quality 2 년 전
profile.go ADD EVERYTHING TO TEMPLATES FILE OH YEAH 2 년 전
pw.go Create token revocation page 2 년 전
rate_limiter.go use getContext instead of MustGet("context").(context) 3 년 전
recovery.go Update vendor 2 년 전
register.go Don't add user to leaderboard when they register 2 년 전
semantic.json Display achievements on user profiles 1 년 전
sessions.go Make Language set in the Context, not by the template 2 년 전
simple.go ADD EVERYTHING TO TEMPLATES FILE OH YEAH 2 년 전
startuato_linux.go deploy a specific branch 2 년 전
startuato_windows.go When refreshing templates, restart the entire webserver 3 년 전
templates.go ignore non-html files while loading templates 1 년 전
tracking.go Move from git.zxq.co to zxq.co 2 년 전
yarn.lock Start implementing localisation in JavaScript 2 년 전

README.md

Hanayo build status

This repository has a mirror here. The original repo is still here.

To fellow developers: this is not how you do it!

The biggest flaw of hanayo are that when I set out to create it, I wanted to create a template system that:

  • Created a handler by simply having the file “be there”
  • Could fetch the data it needed on its own, often from the Ripple API
  • Had the actual Go code be as little as possible

This was not immediately evident to me, a Go beginner, but what I did there was basically make Go be PHP.

The biggest lesson I learned on how to properly do templates, was learning to use Vue. Yes, Vue can be used for the frontend and not really for server-rendered stuff, but even just learning how to do stuff with it can help you understand what a template is actually supposed to be in order to be maintainable.

The key concepts and insights for me where:

  • Separating clearly code and markup, making the template declarative and keeping as little code in the template
  • A template should be purely functional. Its mere creation should not generate side effects, nor should it be dependent on things that are not its precise inputs: for a given input there is a specific output.
  • The concept of component as a single self-contained entity which is the same wherever you use it is very powerful.
  • Once a template/component starts becoming too big, split it into more components.

But don’t stop here. Actually making a project using Vue helps you to understand this much more easily than using mere words. Go ahead and build something, even if just to play around!