Blogly assignment complete

.env.example

@@ -0,0 +1,6 @@
+BETTER_AUTH_SECRET=
+BETTER_AUTH_URL=
+NEON_BRANCH=
+DATABASE_URL=
+DATABASE_URL_UNPOOLED=
+UPLOADTHING_TOKEN=

.gitignore

@@ -32,10 +32,12 @@ yarn-error.log*
 
 # env files (can opt-in for committing if needed)
 .env*
+!.env.example
 
 # vercel
 .vercel
 
 # typescript
 *.tsbuildinfo
 next-env.d.ts
+.neon

BLOGLY.md

@@ -0,0 +1,130 @@
+# Blogly
+
+![screenshot](./public/ss1.png)
+
+A multi-author blogging app. Anyone can read. Sign-in is required to write, comment, like, and follow.
+
+## Stack
+
+| Layer | Choice |
+| --- | --- |
+| Runtime | Node.js 20+, Next.js 16 (App Router, Cache Components) |
+| UI | React 19, Tailwind CSS 4, shadcn/ui (Base UI), Remixicon |
+| Auth | Better Auth (email/password) |
+| Database | Neon Postgres, Drizzle ORM |
+| Uploads | UploadThing |
+| Editor | Tiptap 3 |
+| Package manager | npm |
+
+## Requirements
+
+- Node.js 20+
+- A Neon (or other Postgres) database
+- An [UploadThing](https://uploadthing.com) token
+
+## Environment
+
+Copy `.env.example` to `.env` and fill in:
+
+| Variable | Purpose |
+| --- | --- |
+| `DATABASE_URL` | Pooled Postgres URL (app) |
+| `DATABASE_URL_UNPOOLED` | Direct Postgres URL (migrations) |
+| `BETTER_AUTH_SECRET` | Auth signing secret |
+| `BETTER_AUTH_URL` | Public origin, e.g. `http://localhost:3000` |
+| `UPLOADTHING_TOKEN` | Image uploads |
+| `NEON_BRANCH` | Optional Neon branch name |
+
+## Setup
+
+```bash
+npm ci
+npx drizzle-kit migrate
+npm run db:seed
+npm run dev
+```
+
+App: `http://localhost:3000`
+
+Seed accounts use password `SeedPass1!`:
+
+- `mira@blogly.dev` / `mira`
+- `julian@blogly.dev` / `julian`
+- `elena@blogly.dev` / `elena`
+
+Re-running the seed is idempotent for those authors.
+
+## Scripts
+
+| Command | Action |
+| --- | --- |
+| `npm run dev` | Dev server |
+| `npm run build` | Production build |
+| `npm run start` | Serve the build |
+| `npm run lint` | ESLint |
+| `npm run db:generate` | Generate a Drizzle migration |
+| `npm run db:migrate` | Apply migrations |
+| `npm run db:seed` | Seed sample authors and posts |
+
+## Routes
+
+| Path | Access |
+| --- | --- |
+| `/` | Public feed (For You, Following) |
+| `/search?q=` | Public search (posts/people, sort, tags, recency) |
+| `/signin`, `/signup` | Auth |
+| `/[username]` | Public author profile |
+| `/[username]/[slug]` | Public post |
+| `/admin` | Own posts (session) |
+| `/admin/new`, `/admin/[postId]/edit` | Editor (session) |
+| `/settings/account` | Profile, avatar, header image |
+| `/settings/security` | Password |
+| `/settings/manage` | Account management |
+| `/api/auth/[...all]` | Better Auth |
+| `/api/uploadthing` | Uploads |
+
+Reserved usernames: `admin`, `signin`, `signup`, `settings`, `api`, `search`.
+
+## Data
+
+Postgres tables: `user`, `session`, `account`, `verification`, `blogs`, `comments`, `likes`, `follows`.
+
+Posts: `draft` \| `published` \| `archived`. Slugs are unique per author. Public lists show published posts from non-disabled users, 8 per page.
+
+Schema lives in `lib/db/schemas/`. Migrations live in `drizzle/`.
+
+## Auth and uploads
+
+Better Auth stores credentials in Postgres. Sessions are read through `lib/session.ts`. Sign-up requires name, unique email, unique username, and a password of at least 8 characters.
+
+UploadThing routes (signed-in only):
+
+- `coverImage`, `postImage`, `headerImage` — 8 MB
+- `avatarImage` — 4 MB
+
+URLs are stored on the user or post row.
+
+## Caching
+
+`cacheComponents` is on. Public post queries use `"use cache"` with tag `posts`. Mutations in `app/actions/` call `updateTag` and `revalidatePath` so new posts appear without a hard reload.
+
+## Layout
+
+```
+app/                 routes, server actions, API
+components/          UI (editor, cards, settings)
+lib/db/              schema, queries, seed
+lib/                 auth, session, cache, search
+drizzle/             SQL migrations
+```
+
+## Screenshots
+
+![screenshot](./public/ss2.png)
+![screenshot](./public/ss3.png)
+![screenshot](./public/ss4.png)
+![screenshot](./public/ss5.png)
+![screenshot](./public/ss6.png)
+![screenshot](./public/ss7.png)
+![screenshot](./public/ss8.png)
+![screenshot](./public/ss9.png)

README.md

@@ -2,6 +2,9 @@
 
 © 2026 Renderbit Technologies Pvt. Ltd.
 
+>[!NOTE]
+> Read [BLOGLY.md](./BLOGLY.md) for technical documentation.
+
 ## Prerequisites
 
 You should be familiar with Node.js, React, Next.js, Git and GitHub.

app/(auth)/layout.tsx

@@ -0,0 +1,22 @@
+import Link from "next/link";
+import { ModeToggle } from "@/components/mode-toggle";
+
+export default function AuthLayout({
+  children,
+}: {
+  children: React.ReactNode;
+}) {
+  return (
+    <div className="relative min-h-svh bg-background">
+      <div className="absolute inset-x-0 top-0 z-10 flex items-center justify-between px-6 py-5">
+        <Link href="/" className="text-2xl font-extrabold tracking-tight">
+          Blogly.
+        </Link>
+        <ModeToggle />
+      </div>
+      <div>
+        {children}
+      </div>
+    </div>
+  );
+}

app/(auth)/signin/page.tsx

@@ -0,0 +1,25 @@
+import { redirect } from "next/navigation";
+import { SignInForm } from "@/components/auth/sign-in-form";
+import { safeNextPath } from "@/lib/safe-next";
+import { getSession } from "@/lib/session";
+
+export const instant = false;
+
+export const metadata = {
+  title: "Sign in · Blogly",
+  description: "Sign in to write and publish on Blogly.",
+};
+
+export default async function SignInPage({
+  searchParams,
+}: {
+  searchParams: Promise<{ next?: string }>;
+}) {
+  const session = await getSession();
+  const nextPath = safeNextPath((await searchParams).next);
+  if (session?.user) {
+    redirect(nextPath);
+  }
+
+  return <SignInForm nextPath={nextPath} />;
+}

app/(auth)/signup/page.tsx

@@ -0,0 +1,19 @@
+import { redirect } from "next/navigation";
+import { SignUpForm } from "@/components/auth/sign-up-form";
+import { getSession } from "@/lib/session";
+
+export const instant = false;
+
+export const metadata = {
+  title: "Sign up · Blogly",
+  description: "Create a Blogly account and claim your username.",
+};
+
+export default async function SignUpPage() {
+  const session = await getSession();
+  if (session?.user) {
+    redirect("/");
+  }
+
+  return <SignUpForm />;
+}

app/(home)/[username]/[slug]/loading.tsx

@@ -0,0 +1,10 @@
+export default function PostLoading() {
+  return (
+    <div className="mx-auto min-h-svh w-full max-w-3xl px-4 pb-16 sm:px-0 mt-5">
+      <div className="aspect-16/9 rounded-2xl bg-muted" />
+      <div className="mt-6 h-10 w-3/4 rounded bg-muted" />
+      <div className="mt-4 h-4 w-full rounded bg-muted" />
+      <div className="mt-2 h-4 w-5/6 rounded bg-muted" />
+    </div>
+  );
+}