create-m5kdev 0.4.0

package/templates/minimal-app/apps/server/src/modules/posts/posts.repository.ts.tpl

@@ -0,0 +1,106 @@
+import type {
+  PostSchema,
+  PostsListInputSchema,
+  PostsListOutputSchema,
+} from "{{PACKAGE_SCOPE}}/shared/modules/posts/posts.schema";
+import { BaseTableRepository } from "@m5kdev/backend/modules/base/base.repository";
+import type { ServerResultAsync } from "@m5kdev/backend/utils/types";
+import { and, asc, count, desc, eq, isNull, like, ne, or } from "drizzle-orm";
+import { ok } from "neverthrow";
+import type { Orm, Schema } from "../../db";
+
+export class PostsRepository extends BaseTableRepository<
+  Orm,
+  Schema,
+  Record<string, never>,
+  Schema["posts"]
+> {
+  async list(input: PostsListInputSchema = {}): ServerResultAsync<PostsListOutputSchema> {
+    return this.throwableAsync(async () => {
+      const page = input.page ?? 1;
+      const limit = input.limit ?? 6;
+      const search = input.search?.trim();
+      const conditions = [isNull(this.table.deletedAt)];
+
+      if (input.status) {
+        conditions.push(eq(this.table.status, input.status));
+      }
+
+      if (search) {
+        const pattern = `%${search}%`;
+        const searchCondition = or(
+          like(this.table.title, pattern),
+          like(this.table.slug, pattern),
+          like(this.table.excerpt, pattern),
+          like(this.table.content, pattern)
+        );
+
+        if (searchCondition) {
+          conditions.push(searchCondition);
+        }
+      }
+
+      const whereClause = and(...conditions);
+      const ordering =
+        input.sort === "title"
+          ? input.order === "asc"
+            ? asc(this.table.title)
+            : desc(this.table.title)
+          : input.sort === "publishedAt"
+            ? input.order === "asc"
+              ? asc(this.table.publishedAt)
+              : desc(this.table.publishedAt)
+            : input.order === "asc"
+              ? asc(this.table.updatedAt)
+              : desc(this.table.updatedAt);
+
+      const rows = await this.orm
+        .select()
+        .from(this.table)
+        .where(whereClause)
+        .orderBy(ordering, desc(this.table.createdAt))
+        .limit(limit)
+        .offset((page - 1) * limit);
+
+      const [totalRow] = await this.orm
+        .select({ count: count() })
+        .from(this.table)
+        .where(whereClause);
+
+      return ok({
+        rows: rows as PostSchema[],
+        total: totalRow?.count ?? 0,
+      });
+    });
+  }
+
+  async findBySlug(slug: string, excludeId?: string) {
+    return this.throwableAsync(async () => {
+      const whereClause = excludeId
+        ? and(eq(this.table.slug, slug), ne(this.table.id, excludeId), isNull(this.table.deletedAt))
+        : and(eq(this.table.slug, slug), isNull(this.table.deletedAt));
+
+      const [row] = await this.orm.select().from(this.table).where(whereClause).limit(1);
+      return ok(row);
+    });
+  }
+
+  async resolveUniqueSlug(candidate: string, excludeId?: string) {
+    let slug = candidate;
+    let suffix = 2;
+
+    while (true) {
+      const existing = await this.findBySlug(slug, excludeId);
+      if (existing.isErr()) {
+        return existing;
+      }
+
+      if (!existing.value) {
+        return ok(slug);
+      }
+
+      slug = `${candidate}-${suffix}`;
+      suffix += 1;
+    }
+  }
+}

package/templates/minimal-app/apps/server/src/modules/posts/posts.service.ts.tpl

@@ -0,0 +1,150 @@
+import type {
+  PostCreateInputSchema,
+  PostCreateOutputSchema,
+  PostPublishInputSchema,
+  PostPublishOutputSchema,
+  PostSoftDeleteInputSchema,
+  PostSoftDeleteOutputSchema,
+  PostsListInputSchema,
+  PostsListOutputSchema,
+  PostUpdateInputSchema,
+  PostUpdateOutputSchema,
+} from "{{PACKAGE_SCOPE}}/shared/modules/posts/posts.schema";
+import { BaseService } from "@m5kdev/backend/modules/base/base.service";
+import type { ServerResultAsync } from "@m5kdev/backend/utils/types";
+import { err, ok } from "neverthrow";
+import type { PostsRepository } from "./posts.repository";
+
+type RequestContext = {
+  session: {
+    activeOrganizationId?: string | null;
+    activeTeamId?: string | null;
+  };
+  user: {
+    id: string;
+  };
+};
+
+export class PostsService extends BaseService<{ posts: PostsRepository }, Record<string, never>> {
+  async list(
+    input: PostsListInputSchema,
+    _ctx: RequestContext
+  ): ServerResultAsync<PostsListOutputSchema> {
+    return this.repository.posts.list(input);
+  }
+
+  async create(
+    input: PostCreateInputSchema,
+    ctx: RequestContext
+  ): ServerResultAsync<PostCreateOutputSchema> {
+    const uniqueSlug = await this.repository.posts.resolveUniqueSlug(
+      this.slugify(input.slug ?? input.title)
+    );
+    if (uniqueSlug.isErr()) {
+      return err(uniqueSlug.error);
+    }
+
+    return this.repository.posts.create({
+      authorUserId: ctx.user.id,
+      organizationId: ctx.session.activeOrganizationId ?? null,
+      teamId: ctx.session.activeTeamId ?? null,
+      title: input.title.trim(),
+      slug: uniqueSlug.value,
+      excerpt: this.createExcerpt(input.excerpt, input.content),
+      content: input.content.trim(),
+      status: "draft",
+    }) as ServerResultAsync<PostCreateOutputSchema>;
+  }
+
+  async update(
+    input: PostUpdateInputSchema,
+    _ctx: RequestContext
+  ): ServerResultAsync<PostUpdateOutputSchema> {
+    const current = await this.repository.posts.findById(input.id);
+    if (current.isErr()) {
+      return err(current.error);
+    }
+    if (!current.value || current.value.deletedAt) {
+      return this.error("NOT_FOUND", "Post not found");
+    }
+
+    const uniqueSlug = await this.repository.posts.resolveUniqueSlug(
+      this.slugify(input.slug ?? input.title),
+      input.id
+    );
+    if (uniqueSlug.isErr()) {
+      return err(uniqueSlug.error);
+    }
+
+    return this.repository.posts.update({
+      id: input.id,
+      title: input.title.trim(),
+      slug: uniqueSlug.value,
+      excerpt: this.createExcerpt(input.excerpt, input.content),
+      content: input.content.trim(),
+    }) as ServerResultAsync<PostUpdateOutputSchema>;
+  }
+
+  async publish(
+    input: PostPublishInputSchema,
+    _ctx: RequestContext
+  ): ServerResultAsync<PostPublishOutputSchema> {
+    const current = await this.repository.posts.findById(input.id);
+    if (current.isErr()) {
+      return err(current.error);
+    }
+    if (!current.value || current.value.deletedAt) {
+      return this.error("NOT_FOUND", "Post not found");
+    }
+
+    return this.repository.posts.update({
+      id: input.id,
+      status: "published",
+      publishedAt: current.value.publishedAt ?? new Date(),
+    }) as ServerResultAsync<PostPublishOutputSchema>;
+  }
+
+  async softDelete(
+    input: PostSoftDeleteInputSchema,
+    _ctx: RequestContext
+  ): ServerResultAsync<PostSoftDeleteOutputSchema> {
+    const current = await this.repository.posts.findById(input.id);
+    if (current.isErr()) {
+      return err(current.error);
+    }
+    if (!current.value || current.value.deletedAt) {
+      return this.error("NOT_FOUND", "Post not found");
+    }
+
+    const updated = await this.repository.posts.update({
+      id: input.id,
+      deletedAt: new Date(),
+    });
+
+    if (updated.isErr()) {
+      return err(updated.error);
+    }
+
+    return ok({ id: updated.value.id });
+  }
+
+  private slugify(value: string): string {
+    const slug = value
+      .trim()
+      .toLowerCase()
+      .replace(/[^a-z0-9]+/g, "-")
+      .replace(/^-+/g, "")
+      .replace(/-+$/g, "")
+      .replace(/-{2,}/g, "-");
+
+    return slug || "post";
+  }
+
+  private createExcerpt(excerpt: string | undefined, content: string): string {
+    if (excerpt?.trim()) {
+      return excerpt.trim();
+    }
+
+    return content.replace(/\s+/g, " ").trim().slice(0, 180);
+  }
+}

package/templates/minimal-app/apps/server/src/modules/posts/posts.trpc.ts.tpl

@@ -0,0 +1,44 @@
+import {
+  postCreateInputSchema,
+  postCreateOutputSchema,
+  postPublishInputSchema,
+  postPublishOutputSchema,
+  postSoftDeleteInputSchema,
+  postSoftDeleteOutputSchema,
+  postsListInputSchema,
+  postsListOutputSchema,
+  postUpdateInputSchema,
+  postUpdateOutputSchema,
+} from "{{PACKAGE_SCOPE}}/shared/modules/posts/posts.schema";
+import { handleTRPCResult } from "@m5kdev/backend/utils/trpc";
+import { postsService } from "../../service";
+import { procedure, router } from "../../utils/trpc";
+
+export const postsRouter = router({
+  list: procedure
+    .input(postsListInputSchema)
+    .output(postsListOutputSchema)
+    .query(async ({ ctx, input }) => handleTRPCResult(await postsService.list(input ?? {}, ctx))),
+
+  create: procedure
+    .input(postCreateInputSchema)
+    .output(postCreateOutputSchema)
+    .mutation(async ({ ctx, input }) => handleTRPCResult(await postsService.create(input, ctx))),
+
+  update: procedure
+    .input(postUpdateInputSchema)
+    .output(postUpdateOutputSchema)
+    .mutation(async ({ ctx, input }) => handleTRPCResult(await postsService.update(input, ctx))),
+
+  publish: procedure
+    .input(postPublishInputSchema)
+    .output(postPublishOutputSchema)
+    .mutation(async ({ ctx, input }) => handleTRPCResult(await postsService.publish(input, ctx))),
+
+  softDelete: procedure
+    .input(postSoftDeleteInputSchema)
+    .output(postSoftDeleteOutputSchema)
+    .mutation(async ({ ctx, input }) =>
+      handleTRPCResult(await postsService.softDelete(input, ctx))
+    ),
+});

package/templates/minimal-app/apps/server/src/repository.ts.tpl

@@ -0,0 +1,6 @@
+import { AuthRepository } from "@m5kdev/backend/modules/auth/auth.repository";
+import { orm, schema } from "./db";
+import { PostsRepository } from "./modules/posts/posts.repository";
+
+export const authRepository = new AuthRepository({ orm, schema });
+export const postsRepository = new PostsRepository({ orm, schema, table: schema.posts });

package/templates/minimal-app/apps/server/src/service.ts.tpl

@@ -0,0 +1,12 @@
+import { AuthService } from "@m5kdev/backend/modules/auth/auth.service";
+import { LocalEmailService } from "./lib/localEmailService";
+import { PostsService } from "./modules/posts/posts.service";
+import { authRepository, postsRepository } from "./repository";
+
+export const emailService = new LocalEmailService({
+  appName: "{{APP_NAME}}",
+  appUrl: process.env.VITE_APP_URL ?? "http://localhost:5173",
+});
+
+export const authService = new AuthService({ auth: authRepository }, { email: emailService });
+export const postsService = new PostsService({ posts: postsRepository }, {});

package/templates/minimal-app/apps/server/src/trpc.ts.tpl

@@ -0,0 +1,11 @@
+import type { inferRouterInputs, inferRouterOutputs } from "@trpc/server";
+import { postsRouter as posts } from "./modules/posts/posts.trpc";
+import { router } from "./utils/trpc";
+
+export const appRouter = router({
+  posts,
+});
+
+export type AppRouter = typeof appRouter;
+export type RouterInputs = inferRouterInputs<AppRouter>;
+export type RouterOutputs = inferRouterOutputs<AppRouter>;

package/templates/minimal-app/apps/server/src/types.ts.tpl

@@ -0,0 +1,3 @@
+import type { AppRouter, RouterInputs, RouterOutputs } from "./trpc";
+
+export type { AppRouter, RouterInputs, RouterOutputs };

package/templates/minimal-app/apps/server/src/utils/trpc.ts.tpl

@@ -0,0 +1,27 @@
+import {
+  type createAuthContext,
+  verifyProtectedProcedureContext,
+} from "@m5kdev/backend/utils/trpc";
+import { transformer } from "@m5kdev/commons/utils/trpc";
+import { initTRPC } from "@trpc/server";
+
+type Context = Awaited<ReturnType<ReturnType<typeof createAuthContext>>>;
+
+const t = initTRPC.context<Context>().create({ transformer });
+
+export const publicProcedure = t.procedure;
+
+export const procedure = t.procedure.use(({ ctx, next }) => {
+  verifyProtectedProcedureContext(ctx);
+  return next({ ctx });
+});
+
+export const router = t.router;
+export const mergeRouters = t.mergeRouters;
+
+export const trpcObject = {
+  router,
+  privateProcedure: procedure,
+  adminProcedure: procedure,
+  publicProcedure,
+};

package/templates/minimal-app/apps/server/tsconfig.json.tpl

@@ -0,0 +1,13 @@
+{
+  "extends": "@m5kdev/config/tsconfig.node.json",
+  "rootDir": ".",
+  "compilerOptions": {
+    "esModuleInterop": true,
+    "importHelpers": true,
+    "jsx": "react-jsx",
+    "noEmit": true,
+    "tsBuildInfoFile": "dist/tsconfig.tsbuildinfo"
+  },
+  "exclude": ["node_modules"],
+  "include": ["src/**/*.ts", "drizzle/**/*.ts", "drizzle.config.ts", "tsup.config.ts"]
+}

package/templates/minimal-app/apps/server/tsup.config.ts.tpl

@@ -0,0 +1,9 @@
+import { defineConfig } from "tsup";
+
+export default defineConfig({
+  entry: ["src/index.ts"],
+  format: ["cjs"],
+  outDir: "dist",
+  sourcemap: true,
+  clean: true,
+});

package/templates/minimal-app/apps/shared/.env.example.tpl

@@ -0,0 +1,17 @@
+# Auth
+BETTER_AUTH_SECRET=replace-me
+
+# App URLs
+VITE_APP_NAME={{APP_NAME}}
+VITE_APP_URL=http://localhost:5173
+VITE_SERVER_URL=http://localhost:8080
+
+# Database
+DATABASE_URL=file:./local.db
+TURSO_DATABASE_URL=
+TURSO_AUTH_TOKEN=
+
+# Optional email and analytics providers
+RESEND_API_KEY=
+VITE_PUBLIC_POSTHOG_KEY=demo
+VITE_PUBLIC_POSTHOG_HOST=https://us.i.posthog.com

package/templates/minimal-app/apps/shared/.env.tpl

@@ -0,0 +1,19 @@
+# Auth
+BETTER_AUTH_SECRET={{BETTER_AUTH_SECRET}}
+
+# App URLs
+VITE_APP_NAME={{APP_NAME}}
+VITE_APP_URL=http://localhost:5173
+VITE_SERVER_URL=http://localhost:8080
+
+# Database
+DATABASE_URL=file:./local.db
+TURSO_DATABASE_URL=
+TURSO_AUTH_TOKEN=
+
+# Local email delivery falls back to file output when unset
+RESEND_API_KEY=
+
+# Optional PostHog keys
+VITE_PUBLIC_POSTHOG_KEY=demo
+VITE_PUBLIC_POSTHOG_HOST=https://us.i.posthog.com

package/templates/minimal-app/apps/shared/package.json.tpl

@@ -0,0 +1,24 @@
+{
+  "name": "{{PACKAGE_SCOPE}}/shared",
+  "version": "0.0.0",
+  "private": true,
+  "scripts": {
+    "build": "tsc --noEmit",
+    "lint": "biome check .",
+    "lint:fix": "biome check . --write",
+    "check-types": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@m5kdev/commons": "catalog:",
+    "zod": "catalog:"
+  },
+  "devDependencies": {
+    "@m5kdev/config": "catalog:",
+    "tslib": "catalog:",
+    "typescript": "catalog:"
+  },
+  "exports": {
+    "./modules/app/*": "./src/modules/app/*.ts",
+    "./modules/posts/*": "./src/modules/posts/*.ts"
+  }
+}

package/templates/minimal-app/apps/shared/src/modules/posts/posts.constants.ts.tpl

@@ -0,0 +1,5 @@
+export const POST_STATUS_VALUES = ["draft", "published"] as const;
+
+export const POST_FILTER_VALUES = ["all", ...POST_STATUS_VALUES] as const;
+
+export const POSTS_PAGE_SIZE = 6;

package/templates/minimal-app/apps/shared/src/modules/posts/posts.schema.ts.tpl

@@ -0,0 +1,76 @@
+import { querySchema } from "@m5kdev/commons/modules/schemas/query.schema";
+import { z } from "zod";
+import { POST_STATUS_VALUES } from "./posts.constants";
+
+export const postStatusSchema = z.enum(POST_STATUS_VALUES);
+export type PostStatusSchema = z.infer<typeof postStatusSchema>;
+
+export const postSchema = z.object({
+  id: z.string(),
+  authorUserId: z.string().nullish(),
+  organizationId: z.string().nullish(),
+  teamId: z.string().nullish(),
+  title: z.string(),
+  slug: z.string(),
+  excerpt: z.string().nullish(),
+  content: z.string(),
+  status: postStatusSchema,
+  publishedAt: z.date().nullish(),
+  createdAt: z.date(),
+  updatedAt: z.date().nullish(),
+  deletedAt: z.date().nullish(),
+});
+export type PostSchema = z.infer<typeof postSchema>;
+
+export const postsListInputSchema = querySchema.extend({
+  search: z.string().optional(),
+  status: postStatusSchema.optional(),
+});
+export type PostsListInputSchema = z.infer<typeof postsListInputSchema>;
+
+export const postsListOutputSchema = z.object({
+  rows: z.array(postSchema),
+  total: z.number(),
+});
+export type PostsListOutputSchema = z.infer<typeof postsListOutputSchema>;
+
+export const postCreateInputSchema = z.object({
+  title: z.string().min(1),
+  slug: z.string().optional(),
+  excerpt: z.string().optional(),
+  content: z.string().min(1),
+});
+export type PostCreateInputSchema = z.infer<typeof postCreateInputSchema>;
+
+export const postCreateOutputSchema = postSchema;
+export type PostCreateOutputSchema = z.infer<typeof postCreateOutputSchema>;
+
+export const postUpdateInputSchema = z.object({
+  id: z.string(),
+  title: z.string().min(1),
+  slug: z.string().optional(),
+  excerpt: z.string().optional(),
+  content: z.string().min(1),
+});
+export type PostUpdateInputSchema = z.infer<typeof postUpdateInputSchema>;
+
+export const postUpdateOutputSchema = postSchema;
+export type PostUpdateOutputSchema = z.infer<typeof postUpdateOutputSchema>;
+
+export const postPublishInputSchema = z.object({
+  id: z.string(),
+});
+export type PostPublishInputSchema = z.infer<typeof postPublishInputSchema>;
+
+export const postPublishOutputSchema = postSchema;
+export type PostPublishOutputSchema = z.infer<typeof postPublishOutputSchema>;
+
+export const postSoftDeleteInputSchema = z.object({
+  id: z.string(),
+});
+export type PostSoftDeleteInputSchema = z.infer<typeof postSoftDeleteInputSchema>;
+
+export const postSoftDeleteOutputSchema = z.object({
+  id: z.string(),
+});
+export type PostSoftDeleteOutputSchema = z.infer<typeof postSoftDeleteOutputSchema>;

package/templates/minimal-app/apps/shared/tsconfig.json.tpl

@@ -0,0 +1,12 @@
+{
+  "extends": "@m5kdev/config/tsconfig.base.json",
+  "rootDir": ".",
+  "compilerOptions": {
+    "esModuleInterop": true,
+    "importHelpers": true,
+    "noEmit": true,
+    "tsBuildInfoFile": "dist/tsconfig.tsbuildinfo"
+  },
+  "exclude": ["node_modules"],
+  "include": ["src/**/*.ts"]
+}

package/templates/minimal-app/apps/webapp/AGENTS.md.tpl

@@ -0,0 +1,18 @@
+# AGENTS.md
+
+## Frontend Stack
+
+- React + TypeScript
+- React Router v7
+- HeroUI
+- Tailwind CSS v4
+- `nuqs` for URL state
+- TanStack Query + tRPC
+
+## Conventions
+
+- Keep providers centralized in `src/Providers.tsx`.
+- Keep routing in `src/Router.tsx`.
+- Keep feature code grouped under `src/modules/<feature>/`.
+- Prefer HeroUI primitives and existing framework utilities before adding custom abstractions.
+- Use `useTranslation` for local app copy and rely on the bundled `web-ui` translations for auth routes.

package/templates/minimal-app/apps/webapp/index.html.tpl

@@ -0,0 +1,22 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta
+      name="viewport"
+      content="width=device-width, initial-scale=1.0"
+    />
+    <meta
+      name="description"
+      content="{{APP_DESCRIPTION}}"
+    />
+    <title>{{APP_NAME}}</title>
+  </head>
+  <body>
+    <div id="root"></div>
+    <script
+      type="module"
+      src="/src/main.tsx"
+    ></script>
+  </body>
+</html>

package/templates/minimal-app/apps/webapp/package.json.tpl

@@ -0,0 +1,52 @@
+{
+  "name": "{{PACKAGE_SCOPE}}/webapp",
+  "private": true,
+  "version": "0.0.0",
+  "type": "module",
+  "scripts": {
+    "dev": "vite",
+    "build": "vite build",
+    "lint": "biome check .",
+    "lint:fix": "biome check . --write",
+    "check-types": "tsc --noEmit",
+    "preview": "vite preview"
+  },
+  "dependencies": {
+    "{{PACKAGE_SCOPE}}/shared": "workspace:*",
+    "@heroui/react": "catalog:",
+    "@m5kdev/commons": "catalog:",
+    "@m5kdev/frontend": "catalog:",
+    "@m5kdev/web-ui": "catalog:",
+    "@tanstack/react-query": "catalog:",
+    "@tanstack/react-query-devtools": "catalog:",
+    "@trpc/client": "catalog:",
+    "@trpc/tanstack-react-query": "catalog:",
+    "better-auth": "catalog:",
+    "i18next": "catalog:",
+    "lucide-react": "catalog:",
+    "nuqs": "catalog:",
+    "posthog-js": "catalog:",
+    "react": "catalog:",
+    "react-dom": "catalog:",
+    "react-hook-form": "catalog:",
+    "react-i18next": "catalog:",
+    "react-router": "catalog:",
+    "sonner": "catalog:",
+    "tailwindcss": "catalog:",
+    "tw-animate-css": "catalog:",
+    "zod": "catalog:"
+  },
+  "devDependencies": {
+    "{{PACKAGE_SCOPE}}/server": "workspace:*",
+    "@m5kdev/config": "catalog:",
+    "@tailwindcss/vite": "catalog:",
+    "@types/react": "catalog:",
+    "@types/react-dom": "catalog:",
+    "@vitejs/plugin-react": "catalog:",
+    "babel-plugin-react-compiler": "catalog:",
+    "typescript": "catalog:",
+    "vite": "catalog:",
+    "vite-plugin-i18next-loader": "catalog:",
+    "vite-tsconfig-paths": "catalog:"
+  }
+}

package/templates/minimal-app/apps/webapp/src/App.tsx.tpl

@@ -0,0 +1,13 @@
+import { NuqsAdapter } from "nuqs/adapters/react-router/v7";
+import { BrowserRouter } from "react-router";
+import { Providers } from "./Providers";
+
+export function App() {
+  return (
+    <NuqsAdapter>
+      <BrowserRouter>
+        <Providers />
+      </BrowserRouter>
+    </NuqsAdapter>
+  );
+}