@nubase/create 0.1.9 → 0.1.12

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nubase/create",
-  "version": "0.1.9",
+  "version": "0.1.12",
   "description": "Create a new Nubase application",
   "type": "module",
   "bin": {

package/templates/backend/src/api/routes/dashboard.ts

@@ -0,0 +1,122 @@
+import { createHttpHandler } from "@nubase/backend";
+import { apiEndpoints } from "schema";
+
+/**
+ * Dashboard widget endpoints.
+ * These return hardcoded data for demonstration - real implementations would query the database.
+ */
+export const dashboardHandlers = {
+	/** Revenue chart - returns series data for area/line/bar charts. */
+	getRevenueChart: createHttpHandler({
+		endpoint: apiEndpoints.getRevenueChart,
+		handler: async () => ({
+			type: "series",
+			config: {
+				keys: ["desktop", "mobile"],
+			},
+			data: [
+				{ category: "January", desktop: 186, mobile: 80 },
+				{ category: "February", desktop: 305, mobile: 200 },
+				{ category: "March", desktop: 237, mobile: 120 },
+				{ category: "April", desktop: 73, mobile: 190 },
+				{ category: "May", desktop: 209, mobile: 130 },
+				{ category: "June", desktop: 214, mobile: 140 },
+			],
+		}),
+	}),
+
+	/** Browser stats - returns proportional data for pie/donut charts. */
+	getBrowserStats: createHttpHandler({
+		endpoint: apiEndpoints.getBrowserStats,
+		handler: async () => ({
+			type: "proportional",
+			data: [
+				{ label: "Chrome", value: 275 },
+				{ label: "Safari", value: 200 },
+				{ label: "Firefox", value: 187 },
+				{ label: "Edge", value: 173 },
+				{ label: "Other", value: 90 },
+			],
+		}),
+	}),
+
+	/** Total revenue KPI - returns single value with trend. */
+	getTotalRevenue: createHttpHandler({
+		endpoint: apiEndpoints.getTotalRevenue,
+		handler: async () => ({
+			type: "kpi",
+			value: "$45,231.89",
+			label: "Total Revenue",
+			trend: "+20.1% from last month",
+			trendDirection: "up",
+		}),
+	}),
+
+	/** Active users KPI - returns single value with trend. */
+	getActiveUsers: createHttpHandler({
+		endpoint: apiEndpoints.getActiveUsers,
+		handler: async () => ({
+			type: "kpi",
+			value: "+2,350",
+			label: "Active Users",
+			trend: "+180.1% from last month",
+			trendDirection: "up",
+		}),
+	}),
+
+	/** Sales chart - returns series data for bar charts. */
+	getSalesChart: createHttpHandler({
+		endpoint: apiEndpoints.getSalesChart,
+		handler: async () => ({
+			type: "series",
+			config: {
+				keys: ["sales"],
+			},
+			data: [
+				{ category: "Mon", sales: 12 },
+				{ category: "Tue", sales: 19 },
+				{ category: "Wed", sales: 3 },
+				{ category: "Thu", sales: 5 },
+				{ category: "Fri", sales: 2 },
+				{ category: "Sat", sales: 8 },
+				{ category: "Sun", sales: 15 },
+			],
+		}),
+	}),
+
+	/** Recent activity - returns table data. */
+	getRecentActivity: createHttpHandler({
+		endpoint: apiEndpoints.getRecentActivity,
+		handler: async () => ({
+			type: "table",
+			columns: [
+				{ key: "user", label: "User", width: "30%" },
+				{ key: "action", label: "Action", width: "40%" },
+				{ key: "time", label: "Time", width: "30%" },
+			],
+			rows: [
+				{ user: "John Doe", action: "Created a new ticket", time: "2 min ago" },
+				{
+					user: "Jane Smith",
+					action: "Updated project settings",
+					time: "5 min ago",
+				},
+				{
+					user: "Bob Johnson",
+					action: "Closed ticket #123",
+					time: "10 min ago",
+				},
+				{
+					user: "Alice Brown",
+					action: "Added comment on ticket #456",
+					time: "15 min ago",
+				},
+				{
+					user: "Charlie Wilson",
+					action: "Assigned ticket to team",
+					time: "20 min ago",
+				},
+			],
+		}),
+	}),
+};

package/templates/backend/src/index.ts

@@ -2,9 +2,10 @@ import { serve } from "@hono/node-server";
 import { createAuthMiddleware, registerHandlers } from "@nubase/backend";
 import { Hono } from "hono";
 import { cors } from "hono/cors";
-import { ticketHandlers } from "./api/routes/ticket";
 import { authHandlers } from "./api/routes/auth";
+import { dashboardHandlers } from "./api/routes/dashboard";
 import { testUtilsHandlers } from "./api/routes/test-utils";
+import { ticketHandlers } from "./api/routes/ticket";
 import {
 	createPostAuthWorkspaceMiddleware,
 	createWorkspaceMiddleware,
@@ -50,6 +51,7 @@ app.get("/", (c) => c.json({ message: "Welcome to __PROJECT_NAME_PASCAL__ API" }
 // Register all handlers - path and method extracted from endpoint metadata
 registerHandlers(app, authHandlers);
 registerHandlers(app, ticketHandlers);
+registerHandlers(app, dashboardHandlers);
 
 // Register test utility handlers (only in test environment)
 if (process.env.NODE_ENV === "test") {

package/templates/frontend/src/config.tsx

@@ -3,6 +3,7 @@ import { defaultKeybindings, resourceLink } from "@nubase/frontend";
 import { Home, TicketIcon } from "lucide-react";
 import { apiEndpoints } from "schema";
 import { __PROJECT_NAME_PASCAL__AuthController } from "./auth/__PROJECT_NAME_PASCAL__AuthController";
+import { analyticsDashboard } from "./dashboards/analytics";
 import { ticketResource } from "./resources/ticket";
 
 const apiBaseUrl =
@@ -35,4 +36,7 @@ export const config: NubaseFrontendConfig<typeof apiEndpoints> = {
 	defaultThemeId: "dark",
 	authentication: authController,
 	publicRoutes: ["/signin"],
+	dashboards: {
+		[analyticsDashboard.id]: analyticsDashboard,
+	},
 };

package/templates/frontend/src/dashboards/analytics.ts

@@ -0,0 +1,67 @@
+import { createDashboard } from "@nubase/frontend";
+import { apiEndpoints } from "schema";
+
+/**
+ * Analytics dashboard configuration.
+ *
+ * This dashboard demonstrates the type-safe widget system:
+ * - Each widget references an endpoint that returns the correct data type
+ * - TypeScript will error if you try to use a non-matching endpoint
+ * - Layout is defined using react-grid-layout coordinates (x, y, w, h)
+ */
+export const analyticsDashboard = createDashboard("analytics")
+	.withApiEndpoints(apiEndpoints)
+	.withTitle("Analytics Dashboard")
+	.withWidgets([
+		// Revenue trend - area chart spanning most of the top row
+		{
+			type: "series",
+			id: "revenue-chart",
+			title: "Revenue Trend",
+			variant: "area",
+			endpoint: "getRevenueChart",
+			defaultLayout: { x: 0, y: 0, w: 8, h: 3 },
+		},
+		// Browser stats - donut chart on the right
+		{
+			type: "proportional",
+			id: "browser-stats",
+			title: "Browser Usage",
+			variant: "donut",
+			endpoint: "getBrowserStats",
+			defaultLayout: { x: 8, y: 0, w: 4, h: 3 },
+		},
+		// KPI cards - second row
+		{
+			type: "kpi",
+			id: "total-revenue",
+			title: "Total Revenue",
+			endpoint: "getTotalRevenue",
+			defaultLayout: { x: 0, y: 3, w: 3, h: 2 },
+		},
+		{
+			type: "kpi",
+			id: "active-users",
+			title: "Active Users",
+			endpoint: "getActiveUsers",
+			defaultLayout: { x: 3, y: 3, w: 3, h: 2 },
+		},
+		// Sales chart - bar chart
+		{
+			type: "series",
+			id: "sales-chart",
+			title: "Weekly Sales",
+			variant: "bar",
+			endpoint: "getSalesChart",
+			defaultLayout: { x: 6, y: 3, w: 6, h: 2 },
+		},
+		// Recent activity table - bottom row
+		{
+			type: "table",
+			id: "recent-activity",
+			title: "Recent Activity",
+			endpoint: "getRecentActivity",
+			maxRows: 5,
+			defaultLayout: { x: 0, y: 5, w: 12, h: 3 },
+		},
+	]);

package/templates/schema/src/api-endpoints.ts

@@ -5,23 +5,24 @@ import {
 	loginStartSchema,
 	logoutSchema,
 	signupSchema,
-} from "./schema/auth";
+} from "./endpoints/auth";
+import {
+	getActiveUsersSchema,
+	getBrowserStatsSchema,
+	getRecentActivitySchema,
+	getRevenueChartSchema,
+	getSalesChartSchema,
+	getTotalRevenueSchema,
+} from "./endpoints/dashboard";
 import {
 	deleteTicketSchema,
 	getTicketSchema,
 	getTicketsSchema,
 	patchTicketSchema,
 	postTicketSchema,
-} from "./schema/ticket";
+} from "./endpoints/ticket";
 
 export const apiEndpoints = {
-	// Tickets
-	getTickets: getTicketsSchema,
-	getTicket: getTicketSchema,
-	postTicket: postTicketSchema,
-	patchTicket: patchTicketSchema,
-	deleteTicket: deleteTicketSchema,
-
 	// Auth
 	loginStart: loginStartSchema,
 	loginComplete: loginCompleteSchema,
@@ -29,6 +30,21 @@ export const apiEndpoints = {
 	logout: logoutSchema,
 	getMe: getMeSchema,
 	signup: signupSchema,
+
+	// Tickets
+	getTickets: getTicketsSchema,
+	getTicket: getTicketSchema,
+	postTicket: postTicketSchema,
+	patchTicket: patchTicketSchema,
+	deleteTicket: deleteTicketSchema,
+
+	// Dashboard widgets
+	getRevenueChart: getRevenueChartSchema,
+	getBrowserStats: getBrowserStatsSchema,
+	getTotalRevenue: getTotalRevenueSchema,
+	getActiveUsers: getActiveUsersSchema,
+	getSalesChart: getSalesChartSchema,
+	getRecentActivity: getRecentActivitySchema,
 } as const;
 
 export type ApiEndpoints = typeof apiEndpoints;

package/templates/schema/src/{schema → endpoints}/auth/get-me.ts

@@ -1,5 +1,5 @@
 import { emptySchema, nu, type RequestSchema } from "@nubase/core";
-import { userSchema } from "./user";
+import { userSchema } from "../../resources/user";
 
 /**
  * Get current user schema

package/templates/schema/src/{schema → endpoints}/auth/index.ts

@@ -4,5 +4,3 @@ export { loginCompleteSchema } from "./login-complete";
 export { loginStartSchema } from "./login-start";
 export { logoutSchema } from "./logout";
 export { signupSchema } from "./signup";
-export { userSchema } from "./user";
-export { workspaceInfoSchema } from "./workspace";

package/templates/schema/src/{schema → endpoints}/auth/login-complete.ts

@@ -1,6 +1,6 @@
 import { emptySchema, nu, type RequestSchema } from "@nubase/core";
-import { userSchema } from "./user";
-import { workspaceInfoSchema } from "./workspace";
+import { userSchema } from "../../resources/user";
+import { workspaceSchema } from "../../resources/workspace";
 
 /**
  * Login complete request schema - Step 2 of two-step auth
@@ -20,6 +20,6 @@ export const loginCompleteSchema = {
 	}),
 	responseBody: nu.object({
 		user: userSchema,
-		workspace: workspaceInfoSchema,
+		workspace: workspaceSchema,
 	}),
 } satisfies RequestSchema;

package/templates/schema/src/{schema → endpoints}/auth/login-start.ts

@@ -1,5 +1,5 @@
 import { emptySchema, nu, type RequestSchema } from "@nubase/core";
-import { workspaceInfoSchema } from "./workspace";
+import { workspaceSchema } from "../../resources/workspace";
 
 /**
  * Login start request schema - Step 1 of two-step auth
@@ -23,6 +23,6 @@ export const loginStartSchema = {
 		/** User's email (for display) */
 		email: nu.string(),
 		/** List of workspaces the user belongs to */
-		workspaces: nu.array(workspaceInfoSchema),
+		workspaces: nu.array(workspaceSchema),
 	}),
 } satisfies RequestSchema;

package/templates/schema/src/{schema → endpoints}/auth/login.ts

@@ -1,5 +1,5 @@
 import { emptySchema, nu, type RequestSchema } from "@nubase/core";
-import { userSchema } from "./user";
+import { userSchema } from "../../resources/user";
 
 /**
  * Legacy login request schema (kept for backwards compatibility)

package/templates/schema/src/{schema → endpoints}/auth/signup.ts

@@ -1,6 +1,6 @@
 import { emptySchema, nu, type RequestSchema } from "@nubase/core";
-import { userSchema } from "./user";
-import { workspaceInfoSchema } from "./workspace";
+import { userSchema } from "../../resources/user";
+import { workspaceSchema } from "../../resources/workspace";
 
 /**
  * Signup request schema
@@ -27,6 +27,6 @@ export const signupSchema = {
 	}),
 	responseBody: nu.object({
 		user: userSchema,
-		workspace: workspaceInfoSchema,
+		workspace: workspaceSchema,
 	}),
 } satisfies RequestSchema;

package/templates/schema/src/endpoints/dashboard/active-users.ts

@@ -0,0 +1,6 @@
+import { createKpiWidgetEndpoint } from "@nubase/core";
+
+/** Active users KPI - returns single value with trend */
+export const getActiveUsersSchema = createKpiWidgetEndpoint(
+	"/dashboard/active-users",
+);

package/templates/schema/src/endpoints/dashboard/browser-stats.ts

@@ -0,0 +1,6 @@
+import { createProportionalWidgetEndpoint } from "@nubase/core";
+
+/** Browser stats - returns proportional data for pie/donut charts */
+export const getBrowserStatsSchema = createProportionalWidgetEndpoint(
+	"/dashboard/browser-stats",
+);

package/templates/schema/src/endpoints/dashboard/index.ts

@@ -0,0 +1,6 @@
+export { getActiveUsersSchema } from "./active-users";
+export { getBrowserStatsSchema } from "./browser-stats";
+export { getRecentActivitySchema } from "./recent-activity";
+export { getRevenueChartSchema } from "./revenue-chart";
+export { getSalesChartSchema } from "./sales-chart";
+export { getTotalRevenueSchema } from "./total-revenue";

package/templates/schema/src/endpoints/dashboard/recent-activity.ts

@@ -0,0 +1,6 @@
+import { createTableWidgetEndpoint } from "@nubase/core";
+
+/** Recent activity - returns table data */
+export const getRecentActivitySchema = createTableWidgetEndpoint(
+	"/dashboard/recent-activity",
+);

package/templates/schema/src/endpoints/dashboard/revenue-chart.ts

@@ -0,0 +1,6 @@
+import { createSeriesWidgetEndpoint } from "@nubase/core";
+
+/** Revenue chart - returns series data for area/line/bar charts */
+export const getRevenueChartSchema = createSeriesWidgetEndpoint(
+	"/dashboard/revenue-chart",
+);

package/templates/schema/src/endpoints/dashboard/sales-chart.ts

@@ -0,0 +1,6 @@
+import { createSeriesWidgetEndpoint } from "@nubase/core";
+
+/** Sales chart - returns series data for bar charts */
+export const getSalesChartSchema = createSeriesWidgetEndpoint(
+	"/dashboard/sales-chart",
+);

package/templates/schema/src/endpoints/dashboard/total-revenue.ts

@@ -0,0 +1,6 @@
+import { createKpiWidgetEndpoint } from "@nubase/core";
+
+/** Total revenue KPI - returns single value with trend */
+export const getTotalRevenueSchema = createKpiWidgetEndpoint(
+	"/dashboard/total-revenue",
+);

package/templates/schema/src/endpoints/index.ts

@@ -0,0 +1,3 @@
+export * from "./auth";
+export * from "./dashboard";
+export * from "./ticket";

package/templates/schema/src/{schema → endpoints}/ticket/get-ticket.ts

@@ -1,9 +1,9 @@
 import { idNumberSchema, type RequestSchema } from "@nubase/core";
-import { ticketBaseSchema } from "./ticket-base";
+import { ticketSchema } from "../../resources/ticket";
 
 export const getTicketSchema = {
 	method: "GET" as const,
 	path: "/tickets/:id",
 	requestParams: idNumberSchema,
-	responseBody: ticketBaseSchema,
+	responseBody: ticketSchema,
 } satisfies RequestSchema;

package/templates/schema/src/{schema → endpoints}/ticket/get-tickets.ts

@@ -1,9 +1,9 @@
 import { nu, type RequestSchema } from "@nubase/core";
-import { ticketBaseSchema } from "./ticket-base";
+import { ticketSchema } from "../../resources/ticket";
 
 export const getTicketsSchema = {
 	method: "GET" as const,
 	path: "/tickets",
-	requestParams: ticketBaseSchema.omit("id").partial(),
-	responseBody: nu.array(ticketBaseSchema),
+	requestParams: ticketSchema.omit("id").partial(),
+	responseBody: nu.array(ticketSchema),
 } satisfies RequestSchema;

package/templates/schema/src/{schema → endpoints}/ticket/index.ts

@@ -3,4 +3,3 @@ export { getTicketSchema } from "./get-ticket";
 export { getTicketsSchema } from "./get-tickets";
 export { patchTicketSchema } from "./patch-ticket";
 export { postTicketSchema } from "./post-ticket";
-export { ticketBaseSchema } from "./ticket-base";

package/templates/schema/src/{schema → endpoints}/ticket/patch-ticket.ts

@@ -1,10 +1,10 @@
 import { idNumberSchema, type RequestSchema } from "@nubase/core";
-import { ticketBaseSchema } from "./ticket-base";
+import { ticketSchema } from "../../resources/ticket";
 
 export const patchTicketSchema = {
 	method: "PATCH" as const,
 	path: "/tickets/:id",
 	requestParams: idNumberSchema,
-	requestBody: ticketBaseSchema.omit("id").partial(),
-	responseBody: ticketBaseSchema,
+	requestBody: ticketSchema.omit("id").partial(),
+	responseBody: ticketSchema,
 } satisfies RequestSchema;

package/templates/schema/src/{schema → endpoints}/ticket/post-ticket.ts

@@ -1,10 +1,10 @@
 import { emptySchema, type RequestSchema } from "@nubase/core";
-import { ticketBaseSchema } from "./ticket-base";
+import { ticketSchema } from "../../resources/ticket";
 
 export const postTicketSchema = {
 	method: "POST" as const,
 	path: "/tickets",
 	requestParams: emptySchema,
-	requestBody: ticketBaseSchema.omit("id"),
-	responseBody: ticketBaseSchema,
+	requestBody: ticketSchema.omit("id"),
+	responseBody: ticketSchema,
 } satisfies RequestSchema;

package/templates/schema/src/index.ts

@@ -1,3 +1,2 @@
 export * from "./api-endpoints";
-export * from "./schema/auth";
-export * from "./schema/ticket";
+export * from "./resources";

package/templates/schema/src/resources/index.ts

@@ -0,0 +1,3 @@
+export { ticketSchema } from "./ticket";
+export { userSchema } from "./user";
+export { workspaceSchema } from "./workspace";

package/templates/schema/src/{schema/ticket/ticket-base.ts → resources/ticket.ts}

@@ -1,6 +1,6 @@
 import { nu } from "@nubase/core";
 
-export const ticketBaseSchema = nu
+export const ticketSchema = nu
 	.object({
 		id: nu.number(),
 		title: nu.string().withMeta({

package/templates/schema/src/{schema/auth → resources}/workspace.ts

@@ -3,7 +3,7 @@ import { nu } from "@nubase/core";
 /**
  * Workspace info returned during login
  */
-export const workspaceInfoSchema = nu.object({
+export const workspaceSchema = nu.object({
 	id: nu.number(),
 	slug: nu.string(),
 	name: nu.string(),