81 lines
1.7 KiB
Markdown
81 lines
1.7 KiB
Markdown
# GoFiber MVC Boilerplate
|
|
|
|
Boilerplate GoFiber MVC + HTMX + Svelte Custom Elements + GORM, con auth server-rendered, area private/admin e mail sink in sviluppo.
|
|
|
|
## Quickstart SQLite
|
|
|
|
```bash
|
|
cp .env.example .env
|
|
make css-build
|
|
make ui-build
|
|
make dev
|
|
```
|
|
|
|
Default SQLite path: `./data/app.sqlite3`.
|
|
|
|
Comandi utili:
|
|
|
|
```bash
|
|
make test
|
|
make fmt
|
|
make db-reset
|
|
```
|
|
|
|
## Quickstart Postgres (Docker Compose)
|
|
|
|
```bash
|
|
docker compose up -d
|
|
cp .env.example .env
|
|
```
|
|
|
|
Configura `.env` così:
|
|
|
|
```env
|
|
DB_DRIVER=postgres
|
|
DB_PG_DSN=postgres://trustcontact:trustcontact@localhost:5432/trustcontact?sslmode=disable
|
|
```
|
|
|
|
`DB_POSTGRES_DSN` è comunque supportato.
|
|
|
|
## Tailwind + UI Kit
|
|
|
|
Tailwind (template server-rendered) compila in `web/static/css/app.css`.
|
|
|
|
UI kit (Svelte custom elements) compila in `web/static/ui`.
|
|
|
|
Comandi:
|
|
|
|
```bash
|
|
make css-build # build tailwind
|
|
make css-dev # watch tailwind
|
|
make ui-build # build ui-kit + css tailwind
|
|
make ui-dev # vite dev server ui-kit
|
|
```
|
|
|
|
Layout include:
|
|
|
|
- `/static/css/app.css?v={{.BuildHash}}`
|
|
- `/static/ui/ui.css?v={{.BuildHash}}`
|
|
- `/static/ui/ui.esm.js?v={{.BuildHash}}`
|
|
|
|
## Template Directories
|
|
|
|
- Public: `web/templates/public`
|
|
- Private: `web/templates/private`
|
|
- Admin: `web/templates/admin`
|
|
|
|
## Email in Develop
|
|
|
|
In `develop`, le email vengono salvate in `./data/emails`.
|
|
|
|
## Make Targets
|
|
|
|
- `make dev` -> `go run ./cmd/server`
|
|
- `make ui-build` -> install + build ui-kit + build css tailwind
|
|
- `make ui-dev` -> watch UI con Vite
|
|
- `make css-build` -> build Tailwind CSS
|
|
- `make css-dev` -> watch Tailwind CSS
|
|
- `make test` -> `go test ./...`
|
|
- `make db-reset` -> reset DB sqlite locale (`./data/app.db` / `./data/app.sqlite3`)
|
|
- `make fmt` -> `gofmt` su `cmd/` e `internal/`
|