Vuka

Appearance

Errors ​

Every diagnostic the vuka toolchain reports has a stable code: the compiler, vuka vet, the editor and the libraries' checks at boot. E is an error and W a warning; the first two digits name the area. Each page says what is wrong, why, and shows the fix. vuka explain E0201 prints the same page in the terminal.

The compiler ​

Code
E0001Internal compiler error
E0002Type error
E0003Syntax error
E0004The Vuka runtime is too old
E0005A dependency doesn't compile
E0006A .templ file doesn't compile

Syntax, JSX and the language ​

Code
E0101JSX syntax error
E0102JSX needs a target
E0103Two JSX targets
E0104The JSX target can't be used
E0105Can't lower a JSX element
E0106A component's attributes don't fit
E0107An event handler doesn't fit
E0108No such ref or attribute value
E0109A field reference names no field
E0110Misplaced ?
E0111Malformed match
E0112A pattern doesn't fit its subject
E0113match isn't exhaustive
E0114Unreachable case
E0115Malformed enum
E0116Malformed static
E0117Can't infer a static's type
E0118Static initialization cycle
E0119A static or field can't be used this way
E0120Conflicting overloads
E0121Ambiguous or unresolvable overload
E0122Can't infer a type argument
E0124Code that can't run in the browser
E0125ui.State used with the wrong type
E0126Bad vuka.File
E0127ui.HTML isn't given one value per label
E0128A value doesn't fit its hole
E0129Attributes and a hand-written schema method
E0130A hook attribute that is no hook
E0131A function an around decorator can't wrap
E0132A value isn't written as its label
E0141A template has two scripts or two scoped stylesheets
E0142A template file has no package clause, or another package's
E0143An unknown element or template
E0144A tag leaves out a parameter
E0146A template file's Go declares no struct
E0147A template file declares more than one struct
E0148A template file has Go and no markup
E0149A state written where nothing sends it to the page
E0150A write the browser can't run
E0151Markup outside a .vuka.html file
E0152A template file declares no struct above its markup
E0153A second template in a template file
E0154An island page that breaks its rules
E0155Tracked state used in a .go file
E0156A Go script with no end tag
E0157A Go script that is not the file's first element
E0158A tag leaves out a required field
W0101A bare name is a field and a name of the package
W0102A live list's items have no key
W0103A stateful component in a loop has no key
W0105A hand-written use of uigen
W0106A hand-written ui.HTML or ui.IslandPage
W0107A .vuka.html file in the Go-header form

Decorators and attributes ​

Code
E0201Malformed attribute
E0202Attribute in the wrong place
E0203An attribute must start its own line
E0204Attribute without a declaration
E0205Bad parameter attribute
E0206Bad field attribute
E0207Attribute on the wrong kind of declaration
E0208Malformed decorator declaration
E0209A decorator composes itself
E0210A typed decorator in a composition
E0211Type decorator on a generic type
E0212Decorated init
E0213A declarer can't take this declaration
E0214Bad @export

Islands and live pages ​

Code
E0301Malformed island import
E0302Island imported twice
E0303Can't read an island component
E0304Can't read an island's props
E0305The JSX target can't import islands
E0306Malformed <ui.Island>
E0307Not an island component
E0308Bad hydration directive
E0309An island's attributes don't fit
E0310Island component not found
E0311Island component is ambiguous
E0312Two islands share a name
E0320Bad @ui.Island arguments
E0321Bad ui.Layout
E0322Bad bind: tag
E0323Bad defer: tag
E0324A deferred field has no loader
E0326Two handles share a name
E0328Bad validate: tag
E0329Bad ui.Live embedding
E0330An island page under @web.Live isn't live
E0331A page backed by a component isn't a GET
E0332@web.Get on a type without @ui.Island
E0334Two Update methods take URL parameters
E0335A LiveSchema field that isn't the page's
E0336A live page hook that doesn't fit
E0337A hook found by its name
E0338A hook declared by the constructor
E0340A path parameter the page doesn't have
W0301A live page routed as a stateless one
W0302A live page configured by struct tags
W0306A hand-written LiveSchema
W0307Two components keeping one URL parameter

Routes and the web app ​

Code
E0401A route is declared twice
E0402A frontend serves a route a handler serves
E0403A handler isn't a function
E0404A route's attribute needs what the app doesn't have
E0405A handler parameter can't be bound
E0406A handler returns what the app can't write
E0407No provider for a dependency
E0408A type is provided twice
E0409A dependency cycle
E0410A constructor has the wrong shape
E0411A cron is wrong
E0412A cron is declared twice
E0413Bad TrustedProxies entry
E0414Implementation[T] finds no one type
E0415An environment variable is missing or invalid
E0416A .env file doesn't parse
E0417A view doesn't fit its template
E0418A service or controller that isn't a struct
E0419A dependency field the URL binds too
E0420A removed way to declare a dependency
E0421Two context processors give one variable
E0422A variable not every main gives
E0423A context processor variable read without a context
E0424An undefined name near a context processor variable
E0425A list entry that is no context processor
E0426Personal values sent to the browser
E0427A web.Var read the app doesn't give
E0428Context processors that need each other
W0401A name shadowing a context processor variable
W0402A direct read where a processor variable would do
W0403A control hidden by a permission its event doesn't check

Data and the ORM ​

Code
E0501A Schema field isn't the model's
E0502A nil Schema attribute
E0503A Schema field behind a pointer

Frontend and toolchain ​

Code
E0601The frontend isn't built
E0602Node.js or the package manager isn't installed
E0603A frontend dependency is missing
E0604An asset declaration can't be read
E0605An asset file isn't there
E0606Two pages share an asset scope
E0607vite.config doesn't use the vuka plugin
E0608TypeScript 7 can't build Vue islands
E0609The islands have no frontend build to go into
E0610npm is older than 11

Folder routes ​

Code
E0701Two pages on one path
E0702Two routes match the same paths
E0703Something is below a catch-all folder
E0704A bracketed name names no path parameter
E0705A path parameter's type can't be in a URL
E0706A name vuka declares for a page is taken
E0707A folder route and a hand-written route share a path
E0708A folder's layout or Guard is malformed
E0709A method handler doesn't fit
E0710A folder's Middleware is malformed
E0711Nothing binds a path parameter
E0712The fields binding a path parameter disagree on its type
E0713A parameter is both a file and a folder
E0714A Params struct makes no parameter folder
E0715A Layout type wraps no folder
E0716A Go file the folder's package can't hold
E0717Two Go files declare one method func
E0718A file is in the way of pages/route.go
E0719A page's struct is declared nowhere
E0720A page declared outside pages/
E0721A page whose markup is written in Go
E0722Two routes on one URL through a route group
E0723A name in parentheses that names no route group
E0724The home page outside the root layouts
W0701No main package serves the folder routes
W0702A hand-written folder-route option
W0703A layout reading the request

Released under the MIT License. Vuka builds on Go and its tools, which are made by the Go Authors. Vuka is not affiliated with Google or the Go project. Go is a trademark of Google LLC.