Skip to content

Using Go, Enhance SSR, and Extism/XTP in the Northstar starter from the Datastar Hypermedia Community

License

Notifications You must be signed in to change notification settings

Benanna2019/PersonalSiteWithGo

Repository files navigation

NORTHSTAR - A Hypermedia Application Starter Template

Stack

Setup

  1. Clone this repository
git clone https://github.com/zangster300/northstar.git
  1. Install Dependencies
pnpm install
go mod tidy
  1. Create 🚀

Development

Live Reload is setup out of the box - powered by Air and templ's proxy server

Use the live task from the Taskfile to start the server

task live

Navigate to http://localhost:7331 in your favorite web browser to begin

Debugging

The debug task will launch delve to begin a debugging session with your project's binary

task debug

IDE Support

Visual Studio Code Integration

Reference

a Debug Main configuration has been added to the launch.json file to set breakpoints

Starting the Server

task run

Navigate to http://localhost:8080 in your favorite web browser

Contributing

Completely open to PR's and feature requests

References

Server

Important

The TODO example relies on the TEMPL_EXPERIMENT=rawgo environment variable being set

Embedded NATS

An embedded NATS server that powers the TODO application is configured and booted up in the router.go file

To interface with it, you should install the nats-cli

Here are some commands to inspect and make changes to the bucket backing the TODO app:

# list key value buckets
nats kv ls

# list keys in the `todos` bucket
nats kv ls todos

# get the value for [key]
nats kv get --raw todos [key]

# put a value into [key]
nats kv put todos [key] '{"todos":[{"text":"Hello, NATS!","completed":true}],"editingIdx":-1,"mode":0}'

Important

To see these updates take place in realtime within the TODO example, make sure your browser is pointed to the real server and not the templ proxy server!

Client

Web Components x Datastar

🔗 Web Components Setup

Hypermedia Architecture

PersonalSiteWithGo

PersonalSiteWithGo

PersonalSiteWithGo

About

Using Go, Enhance SSR, and Extism/XTP in the Northstar starter from the Datastar Hypermedia Community

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published