16 | This example uses lit and SortableJS, you will need to download both libraries before this example will work
17 | Check out this README to learn more
18 |
19 |
20 |
27 |
28 |
29 | }
30 | }
31 |
--------------------------------------------------------------------------------
/nats/nats.go:
--------------------------------------------------------------------------------
1 | package nats
2 |
3 | import (
4 | "context"
5 | "fmt"
6 | "log/slog"
7 | "net"
8 | "os"
9 | "strconv"
10 |
11 | "github.com/delaneyj/toolbelt"
12 | "github.com/delaneyj/toolbelt/embeddednats"
13 | natsserver "github.com/nats-io/nats-server/v2/server"
14 | )
15 |
16 | func SetupNATS(ctx context.Context) (*embeddednats.Server, error) {
17 | natsPort, err := getFreeNatsPort()
18 | if err != nil {
19 | return nil, fmt.Errorf("error obtaining NATS port: %w", err)
20 | }
21 |
22 | ns, err := embeddednats.New(ctx, embeddednats.WithNATSServerOptions(&natsserver.Options{
23 | JetStream: true,
24 | NoSigs: true,
25 | Port: natsPort,
26 | StoreDir: "data/nats",
27 | }))
28 |
29 | if err != nil {
30 | return nil, fmt.Errorf("error creating embedded nats server: %w", err)
31 | }
32 |
33 | ns.WaitForServer()
34 | slog.Info("NATS started", "port", natsPort)
35 |
36 | return ns, nil
37 | }
38 |
39 | func getFreeNatsPort() (int, error) {
40 | if p, ok := os.LookupEnv("NATS_PORT"); ok {
41 | natsPort, err := strconv.Atoi(p)
42 | if err != nil {
43 | return 0, fmt.Errorf("error parsing NATS_PORT: %w", err)
44 | }
45 | if isPortFree(natsPort) {
46 | return natsPort, nil
47 | }
48 | }
49 | return toolbelt.FreePort()
50 | }
51 |
52 | func isPortFree(port int) bool {
53 | address := fmt.Sprintf(":%d", port)
54 |
55 | ln, err := net.Listen("tcp", address)
56 | if err != nil {
57 | return false
58 | }
59 |
60 | if err := ln.Close(); err != nil {
61 | return false
62 | }
63 |
64 | return true
65 | }
66 |
--------------------------------------------------------------------------------
/web/README.md:
--------------------------------------------------------------------------------
1 | # Purpose
2 |
3 | This directory holds web resources
4 |
5 | # Organization
6 |
7 | > [!WARNING]
8 | > If any pathing is updated, make sure to update esbuild [entrypoints](../cmd/web/build/main.go#L28) and pathing in the [`Taskfile.yml` ](../Taskfile.yml)
9 |
10 | ## Libs
11 |
12 | This directory serves as an entrypoint for any custom JS/TS libraries needed for the project to run
13 |
14 | Currently it is being used to hold the following:
15 |
16 | - [Custom Element](https://developer.mozilla.org/en-US/docs/Web/API/Web_components/Using_custom_elements) [Web Components](./libs/web-components/)
17 | - [LitElement](https://lit.dev/) [Web Components](./libs/lit/src/components/)
18 |
19 | ## Resources
20 |
21 | ### Static
22 |
23 | This directory contains static web assets
24 |
25 | ### Styles
26 |
27 | This directory is responsible for styling, it is currently setup to use [TailwindCSS](https://tailwindcss.com/)
28 |
29 | ### `assets.go`
30 |
31 | This file adds some useful pathing variables and sets up the embedded static directory using [hashfs](https://github.com/benbjohnson/hashfs)
32 |
33 | ### `static_dev.go`
34 |
35 | When using the `-tags=dev` build tag, this file supplies an http handler function that serves static assets directly without embedding them, and a function for locating them
36 |
37 | ### `static_prod.go`
38 |
39 | When using the `-tags=prod` build tag (or no build tag), this file supplies an http handler function that embeds static assets directly into the binary using [hashfs](https://github.com/benbjohnson/hashfs), and a function for locating them
40 |
--------------------------------------------------------------------------------
/features/monitor/pages/monitor.templ:
--------------------------------------------------------------------------------
1 | package pages
2 |
3 | import (
4 | "github.com/starfederation/datastar-go/datastar"
5 | "northstar/features/common/components"
6 | "northstar/features/common/layouts"
7 | )
8 |
9 | type SystemMonitorSignals struct {
10 | MemTotal string `json:"memTotal,omitempty"`
11 | MemUsed string `json:"memUsed,omitempty"`
12 | MemUsedPercent string `json:"memUsedPercent,omitempty"`
13 | CpuUser string `json:"cpuUser,omitempty"`
14 | CpuSystem string `json:"cpuSystem,omitempty"`
15 | CpuIdle string `json:"cpuIdle,omitempty"`
16 | }
17 |
18 | templ MonitorPage() {
19 | @layouts.Base("System Monitoring") {
20 | @components.Navigation(components.PageMonitor)
21 |
58 | This mini application is driven by a
59 | single get request!
60 |
61 | As you interact with the UI, the backend state is updated and new partial HTML fragments are sent down to the client via Server-Sent Events. You can make simple apps or full blown SPA replacements with this pattern. Open your dev tools and watch the network tab to see the magic happen (you will want to look for the "/todos" Network/EventStream tab).
62 |
63 |
64 |
65 |
66 |
todo
67 |
68 |
69 | The input is bound to a local store, but this is not a single page application. It is like having HTMX + Alpine.js but with just one API to learn and much easier to extend.
70 |
This mini application is driven by a single get request! As you interact with the UI, the backend state is updated and new partial HTML fragments are sent down to the client via Server-Sent Events. You can make simple apps or full blown SPA replacements with this pattern. Open your dev tools and watch the network tab to see the magic happen (you will want to look for the \"/todos\" Network/EventStream tab).
todo
The input is bound to a local store, but this is not a single page application. It is like having HTMX + Alpine.js but with just one API to learn and much easier to extend.