Quick Start

Install Saasmd CLI globally:

npm install -g saasmd

If you don't already have a Nextjs app, run create-next-app with your preferred package manager.

npx create-next-app@latest saasmd-tutorial

or

yarn create-next-app saasmd-tutorial

or

pnpm dlx create-next-app saasmd-tutorial

or

bunx create-next-app saasmd-tutorial

Then go into the directory of your project:

cd saasmd-tutorial

Then run the following command within the directory of your project:

saasmd init

Note: Saasmd is not compatible with the the pages directory.

Commands

Run these commands within the directory of your Nextjs app:

1. saasmd add

Initializes and configures the following packages for your Next.js project, categorized into:

ORM

Drizzle-ORM

• Based on your chosen database type (PostgreSQL, MySQL, SQLite), Saasmd sets up the required files for Drizzle-ORM, drizzle-zod for validations and and drizzle-kit to manage migrations.
• Scripts are auto-added to package.json for immediate use of drizzle-kit.

Prisma

• Saasmd sets up required files for Prisma with zod-prisma for validations.

---

Authentication

Auth.js

• Generates files for Auth.js (Next-Auth), including the latest Drizzle adapter. (For PlanetScale, references are excluded as it doesn't support foreign keys).
• Generates a generic sign-in component for immediate use within your Next.js project.
• Wraps the root layout with the auth provider and generates utilities for auth checks and redirects in your Next.js routes.

Clerk

• Generates files for Clerk including all necessary config.
• Wraps the root layout with the auth provider and generates utilities for auth checks and redirects in your Next.js routes.

Lucia

• Generates files for Lucia including all necessary config.
• Generates UI and API routes for sign-in and sign-up

Kinde

• Generates files for Kinde including all necessary config.
• Generates sign in component and route handler

---

Other

tRPC

• Generates files to configure tRPC with the app router.
• Provides client-side tRPC and scaffolds server-side configuration using the experimental server-invoker pattern.
• Wraps the root layout in the tRPC provider.

Shadcn-UI

• Installs and configures Shadcn-UI including button and toast components.
• Inserts the toast-provider (<Toaster />) to the root layout for instant toast notifications in your Next.js app.

Stripe

• Installs and configures Stripe within your Next.js project so you can start accepting subscription payments.

Resend

• Installs and configures Resend

Saasmd also adds relevant keys to your .env which you'll need to provide values for.

2. saasmd generate

a) Model:

• Generates a drizzle schema with column types based on your SQL flavor and database provider.
• Uses drizzle-zod to generate Zod schemas for frontend and backend validation.
• Generates queries and mutations for CRUD operations, fully typed and optimized for consumption via a Next.js front-end.

b) Controller:

• Gives you an option to scaffold tRPC, Server Actions and/or API routes.
• Uses Zod schemas from models for request validation.
• Includes built-in error handling for API routes and auto-adding of tRPC routes to the root router.

c) Views:

• Scaffolds views using Shadcn-UI to enable immediate CRUD operations (including select fields for adding relations and datepickers for dates).
• Option to use either React Hook Form with tRPC or plain React (useOptimistic and useValidated Form hooks)

Run in non-interactive mode

As of v0.0.23, you can run saasmd init and saasmd add entirely via the command line as follows:

saasmd init -sf yes -pm bun --orm prisma -db pg -a next-auth -ap github discord -mp trpc stripe resend -cl shadcn-ui -ie yes

Command	Short Flag	Long Option	Description	Argument
init	-	-	initialise and configure saasmd	-
-	-sf	--src-folder	use a src folder	yes or no
-	-pm	--package-manager	package manager	<pm>
-	-cl	--component-lib	component library	<component-lib>
-	-o	--orm	orm	<orm>
-	-db	--db	database ("pg", "mysql", "sqlite")	<db>
-	-dbp	--db-provider	database provider - important if using drizzle	<dbp>
-	-a	--auth	auth	<auth>
-	-ap	--auth-providers	auth providers (if using next-auth)	<providers>
-	-mp	--misc-packages	packages ("trpc", "shadcn-ui", "resend")	<packages>
-	-ie	--include-example	include example	yes or no

Contributing

Keen on enhancing Saasmd? Contributions, bug reports, and feature requests are always welcome. Feel free to open an issue or submit a pull request.

To run locally:

pnpm i
pnpm run dev

npm install -g . (in a second terminal - this will then make saasmd available across your machine using "saasmd *command*")

License

MIT