Skip to content

zangster300/northstar

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

50 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

NORTHSTAR

Stack

Setup

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

Development

Live Reload is setup out of the box - powered by Air

Use the live task from the Taskfile to start with live reload setup

go tool 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

go tool 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

go tool task run

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

Deployment

Building an Executable

The task build task will assemble and build a binary

Docker

# build an image
docker build -t northstar:latest .

# run the image in a container
docker run --name northstar -p 8080:9001 northstar:latest

Dockerfile

Contributing

Completely open to PR's and feature requests

References

Server

Embedded NATS

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

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!

Web Components x Datastar

🔗 Vanilla Web Components Setup

🔗 Lit Web Components Setup

Client

About

Boilerplate for creating real-time Hypermedia applications with Datastar (https://data-star.dev/) and NATS (https://nats.io/)

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Contributors 5