aboutsummaryrefslogtreecommitdiffstats
path: root/man/bolt-new.1
diff options
context:
space:
mode:
Diffstat (limited to 'man/bolt-new.1')
-rw-r--r--man/bolt-new.145
1 files changed, 45 insertions, 0 deletions
diff --git a/man/bolt-new.1 b/man/bolt-new.1
new file mode 100644
index 0000000..c9662a5
--- /dev/null
+++ b/man/bolt-new.1
@@ -0,0 +1,45 @@
+.Dd February 12, 2026
+.Dt BOLT-NEW 1
+.Os
+.Sh NAME
+.Nm bolt-new
+.Nd create a new database migration
+.Sh SYNOPSIS
+.Nm bolt new
+.Op Fl m Ar message
+.Op Fl -message Ar message
+.Sh DESCRIPTION
+.Nm
+creates a new database migration file in the migrations directory.
+.Pp
+The migration file is named using the configured version style (timestamp
+or sequential) followed by the message. For example:
+.Pa 20240316145038_create_users_table.sql .
+.Pp
+When other migrations exist,
+.Nm
+automatically populates the
+.Ql -- depends:
+directive with the current leaf migrations (migrations that no other
+migration depends on). See
+.Xr bolt-dependencies 7
+for details on how dependencies work.
+.Sh OPTIONS
+.Bl -tag -width Ds
+.It Fl m Ar message , Fl -message Ar message
+Message to use for the migration. Default:
+.Qq autogenerated .
+.El
+.Sh EXIT STATUS
+.Nm
+exits 0 on success, and >0 if an error occurs.
+.Sh EXAMPLES
+Create a migration with a message:
+.Dl $ bolt new -m \(dqcreate users table\(dq
+.Pp
+Create a migration with the default message:
+.Dl $ bolt new
+.Sh SEE ALSO
+.Xr bolt 1 ,
+.Xr bolt-migration 5 ,
+.Xr bolt-dependencies 7