https://github.com/norunners/vue
The progressive framework for WebAssembly applications.
https://github.com/norunners/vue
go golang gopherjs vue wasm webassembly
Last synced: 3 months ago
JSON representation
The progressive framework for WebAssembly applications.
- Host: GitHub
- URL: https://github.com/norunners/vue
- Owner: norunners
- License: mit
- Created: 2018-04-29T18:32:16.000Z (about 8 years ago)
- Default Branch: main
- Last Pushed: 2021-12-25T23:20:29.000Z (over 4 years ago)
- Last Synced: 2024-06-19T00:21:16.606Z (about 2 years ago)
- Topics: go, golang, gopherjs, vue, wasm, webassembly
- Language: Go
- Homepage:
- Size: 1.96 MB
- Stars: 235
- Watchers: 15
- Forks: 12
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# vue
[](https://godoc.org/github.com/norunners/vue)
Package `vue` is the progressive framework for [WebAssembly](https://github.com/golang/go/wiki/WebAssembly) applications.
## Install
```bash
GOARCH=wasm GOOS=js go get github.com/norunners/vue
```
*Requires Go 1.12 or higher.*
## Goals
* Provide a unified solution for a framework, state manager and router in the frontend space.
* Leverage [templating](https://github.com/norunners/vueg) to separate application logic from frontend rendering.
* Simplify data binding to ease the relation of state management to rendering.
* Encourage component reuse to promote development productivity.
* Follow an idiomatic Go translation of the familiar Vue API.
## Hello World!
The `main.go` file is compiled to a `.wasm` WebAssembly file.
```go
package main
import "github.com/norunners/vue"
type Data struct {
Message string
}
func main() {
vue.New(
vue.El("#app"),
vue.Template("
{{ Message }}
"),
vue.Data(Data{Message: "Hello WebAssembly!"}),
)
select {}
}
```
The `index.wasmgo.html` file fetches and runs a `.wasm` WebAssembly file.
```html
```
*Note, the example above is compatible with [wasmgo](https://github.com/dave/wasmgo).*
## Serve Examples
Install `wasmgo` to serve examples.
```bash
go get -u github.com/dave/wasmgo
```
Serve an example [locally](http://localhost:8080/).
```bash
cd examples/01-declarative-rendering
wasmgo serve
```
## Status
Alpha - The state of this project is experimental until the common features of Vue are implemented.
The plan is to follow the Vue API closely except for areas of major simplification, which may lead to a subset of the Vue API.
During this stage, the API is expected to encounter minor breaking changes but increase in stability as the project progresses.
## F.A.Q.
#### Why Vue?
One of the common themes of existing frameworks is to combine component application logic with frontend rendering.
This can lead to a confusing mental model to reason about because both concerns may be mixed together in the same logic.
By design, Vue renders components with templates which ensures application logic is developed separately from frontend rending.
Another commonality of existing frameworks is to unnecessarily expose the relation of state management to rendering in the API.
By design, Vue binds data in both directions which ensures automatic updating and rendering when state changes.
This project aims to combine the simplicity of Vue with the power of Go WebAssembly.
License
-------
* [MIT License](LICENSE)