Wrote some initial instructions and decided to use pages/index.md as the instructions and also an example of having markdown do your pages.
parent
3d46f5b1fe
commit
f9b03b2b3d
@ -1,4 +0,0 @@ |
|||||||
<h1>Go Web Dev Starter Kit</h1> |
|
||||||
<block> |
|
||||||
Instructions coming soon... |
|
||||||
</block> |
|
@ -0,0 +1,56 @@ |
|||||||
|
# Go Web Starter Kit |
||||||
|
|
||||||
|
This is a fairly complete web development starter kit in Go. It tries to |
||||||
|
be as simple as possible without leaving out modern features like reactive UIs and database |
||||||
|
migrations. A primary thing that's included is working authentication, since that's the main thing |
||||||
|
holding people back when they first start, and also the easiest to get wrong. |
||||||
|
|
||||||
|
In fact, if you look at how I do it in this first version it is _WRONG_ so do not use this in |
||||||
|
production yet until I can make it correct. Just use it to learn for now. |
||||||
|
|
||||||
|
## Getting Started |
||||||
|
|
||||||
|
You can get use this project working by doing this: |
||||||
|
|
||||||
|
```shell |
||||||
|
git clone \ |
||||||
|
https://git.learnjsthehardway.com/learn-code-the-hard-way/go-web-starter-kit.git my-project |
||||||
|
cd my-project |
||||||
|
``` |
||||||
|
|
||||||
|
Then on Linux/OSX you want to delete the `.git` with this: |
||||||
|
|
||||||
|
```shell |
||||||
|
rm -rf .git |
||||||
|
``` |
||||||
|
|
||||||
|
And on Windows you use the ever more clear and totally easier: |
||||||
|
|
||||||
|
```shell |
||||||
|
rm -recurse -force .git |
||||||
|
``` |
||||||
|
|
||||||
|
Once you have that you can make it your own: |
||||||
|
|
||||||
|
```shell |
||||||
|
git init . |
||||||
|
go mod tidy |
||||||
|
cp config_example.toml config.toml |
||||||
|
make dev |
||||||
|
``` |
||||||
|
|
||||||
|
> __Warning__ On Windows you'll probably be asked to give the `webapp.exe` access to |
||||||
|
the Public and Private networks to use it. |
||||||
|
|
||||||
|
You don't have to use the `Makefile` but it's a lot easier than memorizing the various commands. |
||||||
|
|
||||||
|
You can access the site by visiting https://127.0.0.1:7002/ but keep in mind this is the [Air](https://github.com/air-verse/air) |
||||||
|
port, not _your_ site's port. Air is a tool that will rebuild your Go project whenever you change |
||||||
|
the code (but _NOT_ HTML/CSS, because that's annoying). |
||||||
|
|
||||||
|
## Configuration |
||||||
|
|
||||||
|
|
||||||
|
## Tour of Directories |
||||||
|
|
||||||
|
## More... |
Loading…
Reference in new issue