create-postpipe-appointment

A CLI tool to scaffold a production-ready Appointment System for Next.js applications using MongoDB and Mongoose.

Features

- 📅 Appointment Model: Complete Mongoose schema with validation.
- 🚀 Server Actions: Ready-to-use Next.js Server Actions for creating and fetching appointments.
- 🔌 API Routes: Standard Next.js API route handlers.
- 🛡️ Type Safety: Fully typed with TypeScript.
- 📦 Zero Config: Installs necessary dependencies (mongoose, zod) automatically.

Installation

Run the following command in your Next.js project root:

``bash
npx create-postpipe-appointment
`

What it does

1. Prompts you to confirm the database (currently supports MongoDB).
2. Copies the following files to your project:
- lib/models/Appointment.ts: The Mongoose model.
- lib/actions/appointment.ts: Server actions for form submissions.
- lib/dbConnect.ts: MongoDB connection utility (if not present).
- app/api/appointment/route.ts: API route handler.
3. Installs required dependencies: mongoose, zod.
4. Configures your .env file with a placeholder DATABASE_URI.

Usage

After running the CLI, you can use the generated Server Actions in your components:

`tsx
"use client";

import { useFormState } from "react-dom";
import { createAppointment } from "@/lib/actions/appointment";

export default function AppointmentForm() {
const [state, formAction] = useFormState(createAppointment, {
message: "",
success: false,
});

return (

<br /> <button type="submit">Book Appointment</button> <br /> {state.message && <p>{state.message}</p>} <br /> </form> <br /> ); <br />} <br /></code>`` <br /> <br /><h2 class="text-xl font-semibold mt-5 mb-3">Requirements</h2> <br /> <br />- Next.js (App Router recommended) <br />- MongoDB Database <br /> <br /><h2 class="text-xl font-semibold mt-5 mb-3">License</h2> <br /> <br />CC-BY-NC-SA-4.0 <br /></p></div><div class="flex justify-center absolute inset-x-0 bottom-0 bg-gradient-to-t from-background via-background to-transparent pb-4 pt-16"><button data-slot="button" class="inline-flex items-center justify-center whitespace-nowrap text-sm font-medium transition-all disabled:pointer-events-none disabled:opacity-50 [&_svg]:pointer-events-none [&_svg:not([class*='size-'])]:size-4 shrink-0 [&_svg]:shrink-0 outline-none focus-visible:border-ring focus-visible:ring-ring/50 focus-visible:ring-[3px] aria-invalid:ring-destructive/20 dark:aria-invalid:ring-destructive/40 aria-invalid:border-destructive border bg-background shadow-xs hover:bg-accent hover:text-accent-foreground dark:bg-input/30 dark:border-input dark:hover:bg-input/50 h-8 rounded-md gap-1.5 px-3 has-[>svg]:px-2.5"><svg xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="lucide lucide-chevron-down mr-1 h-4 w-4"><path d="m6 9 6 6 6-6"></path></svg>Show more</button></div></div></div><div data-state="inactive" data-orientation="horizontal" role="tabpanel" aria-labelledby="radix-_R_aav5ubrb_-trigger-dependencies" hidden="" id="radix-_R_aav5ubrb_-content-dependencies" tabindex="0" data-slot="tabs-content" class="flex-1 outline-none mt-6"></div><template id="P:3"></template></div></div></div><div hidden id="S:3"><div data-state="inactive" data-orientation="horizontal" role="tabpanel" aria-labelledby="radix-_R_aav5ubrb_-trigger-versions" hidden="" id="radix-_R_aav5ubrb_-content-versions" tabindex="0" data-slot="tabs-content" class="flex-1 outline-none mt-6"></div></div><script>$RS=function(a,b){a=document.getElementById(a);b=document.getElementById(b);for(a.parentNode.removeChild(a);a.firstChild;)b.parentNode.insertBefore(a.firstChild,b);b.parentNode.removeChild(b)};$RS("S:3","P:3")</script><script>$RC("B:1","S:1")</script></body></html>