LÖVE Template

This is a simple template for making games with LÖVE. It tries to do as little as possible while still being useful for most types of games (or tools).

Should you use this template?

This template is primarily for my own personal use and the way that things are setup matches how I tend to write projects.

If you are an absolute novice to LÖVE, it would be in your best interest to become familiar with the basics first before using any templates.

If you are a beginner/intermediate user of LÖVE and you are not sure what libraries to use or how to layout a project, then this may be what you need.

If you are experienced with LÖVE, you probably know enough to make your own template, and you don't need this anyway. On the other hand, it should also be trivial to modify the code to suit your own needs. It is your choice.

General project guidelines

There are a few guidelines that I follow to keep projects consistent and maintainable.

Modules should be local by default.

This makes it easy to alias the module name. It also keeps the global namespace clean. For further reading: http://kiki.to/blog/2014/03/31/rule-2-return-a-local-table/
```
-- theModule.lua
local theModule = {}
...
return theModule
```
```
-- Other lua file
local theModule = require 'theModule'
```
Common libraries should be global.

If a library is used everywhere, then it might be a good idea to require it globally.
```
Class = require 'libs.class'
```
Global variables should be put into a file called globals.lua.

Ideally, you do not want many global variables in the global namespace, because it makes it hard to keep track of state. To make things even easier, putting global variables in a single file makes it easier to find where they are defined.
Directories should be plural, where applicable.
Directories should not be abbreviated.

There is no technical justification for these two guidelines, but it makes names easier to remember.

Nuthen/Love2D-Template

LÖVE Template

Should you use this template?

General project guidelines