Field types

Fields are written as name:type, separated by commas:

php artisan nevela:resource Product --fields="name:string, sku:string!, price:money, notes:text?"

Suffixes

Suffix	Meaning	Example
?	Optional. The column is nullable.	notes:text?
!	Unique. No two records share a value.	sku:string!

Both can be combined: code:string?!.

Types

Type	Stored as	Validation
string	string	text, up to 255 characters
text	text	text, up to 65,535 characters
email	string	a valid email address
url	string (2,048)	a valid URL
tel	string	text, up to 32 characters
slug	string	letters, numbers, dashes and underscores
color	string	a hex colour such as #1a2b3c
int	integer	a whole number
float	double	a number
money	decimal(12, 2)	a number
percent	double	a number from 0 to 100
rating	integer	a whole number
boolean	boolean	true or false
date	date	a date as YYYY-MM-DD
datetime	dateTime	a date and time
enum(a|b|c)	string, indexed	one of the listed values
belongsTo(Resource)	a foreign key, indexed	the id of a record that exists
image	string (the file’s key)	a picture uploaded to this field
file(pdf|image)	string (the file’s key)	a file of a listed kind, uploaded to this field

The dashboard picks the input and the table column from the type.

Relations and files

category:belongsTo(Category) links a record to one of another resource. It is stored as category_id and called categoryId in the API. See Relationships.

Coming from Grit or Flare

The spellings those two use are understood, so you can type what you know:

You write	Nevela reads it as
image:file:image (Grit)	image:image
image:file:[image] (Flare)	image:image
docs:file:[pdf, image]	docs:file(pdf|image)
category:belongs_to:Category	category:belongsTo(Category)
status:enum:draft|live	status:enum(draft|live)

image:image takes a picture and optimises it as it arrives; image:image(product) names the profile it is optimised with. manual:file(pdf|document) takes other files and stores them as they are. Neither can be unique, sorted by or filtered on. See Files and images.

integer, bool and decimal are accepted as other spellings of int, boolean and money.

Every resource also has id (a UUID), createdAt and updatedAt. You do not declare them, and those names are reserved.