feat(app): initial setup with Next.js 16, Tailwind v4 and (app) route group

.gitignore

@@ -0,0 +1,41 @@
+# See https://help.github.com/articles/ignoring-files/ for more about ignoring files.
+
+# dependencies
+/node_modules
+/.pnp
+.pnp.*
+.yarn/*
+!.yarn/patches
+!.yarn/plugins
+!.yarn/releases
+!.yarn/versions
+
+# testing
+/coverage
+
+# next.js
+/.next/
+/out/
+
+# production
+/build
+
+# misc
+.DS_Store
+*.pem
+
+# debug
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+.pnpm-debug.log*
+
+# env files (can opt-in for committing if needed)
+.env*
+
+# vercel
+.vercel
+
+# typescript
+*.tsbuildinfo
+next-env.d.ts

README.md

@@ -1,2 +1,27 @@
-# waveform
+# Waveform
 
+A modern, high-performance real-time chat application, designed for seamless communication.
+
+![Next.js](https://img.shields.io/badge/Next.js-16-black?style=flat-square&logo=next.js)
+![React](https://img.shields.io/badge/React-19-blue?style=flat-square&logo=react)
+![TypeScript](https://img.shields.io/badge/TypeScript-5-blue?style=flat-square&logo=typescript)
+![Tailwind CSS](https://img.shields.io/badge/Tailwind-v4-38bdf8?style=flat-square&logo=tailwind-css)
+
+## 🛠️ Tech Stack
+
+- **Framework:** [Next.js 16](https://nextjs.org/) (App Router, Route Groups)
+- **UI & Styling:** [React 19](https://react.dev/), [Tailwind CSS v4](https://tailwindcss.com/)
+- **Authentication:** [Auth.js v5 (NextAuth)](https://authjs.dev/) with Credentials Provider & bcrypt hashing _(planned)_
+- **Database & ORM:** [PostgreSQL](https://www.postgresql.org/) managed via [Drizzle ORM](https://orm.drizzle.team/) & Drizzle Kit _(planned)_
+- **DevOps & Infrastructure:** Docker & Docker Compose, Caddy Reverse Proxy, Forgejo Actions _(planned)_
+
+## 📂 Architecture & Structure
+
+The project uses Next.js Route Groups without a `src/` directory to maintain a clean root layout:
+
+- `app/(app)/` — Application routes (Layout, Home)
+- `public/` — Static assets (images, icons, fonts)
+
+## 🎯 Current Status
+
+_In Progress_ — Application scaffold initialized with Next.js 16, React 19, Tailwind CSS v4, and TypeScript. Database integration, authentication, and DevOps infrastructure will be implemented in subsequent phases.

app/(app)/layout.tsx

@@ -0,0 +1,16 @@
+/**
+ * @file app/(app)/layout.tsx
+ * @description Layout component providing a full-screen flex container with overflow clipping for application sub-routes.
+ */
+/**
+
+* App group layout wrapper component.
+*
+* @param {Object} props - The component props.
+* @param {React.ReactNode} props.children - The child elements to be rendered within the layout container.
+* @returns {JSX.Element} The rendered layout container wrapping the child components.
+*/
+
+export default function AppLayout({ children }: { children: React.ReactNode }) {
+  return <div className="flex h-screen w-full overflow-hidden">{children}</div>;
+}

app/(app)/page.tsx

@@ -0,0 +1,33 @@
+/**
+ * @file app/(app)/page.tsx
+ * @description Welcome page component displayed as the initial landing screen of the Waveform application.
+ */
+
+import Image from "next/image";
+
+/**
+ * Renders the welcome page featuring the Waveform logo, main heading, and confirmation text.
+ *
+ * @returns {JSX.Element} The rendered welcome page component.
+ */
+export default function WelcomePage() {
+  return (
+    <main className="flex-1 flex flex-col items-center justify-center p-6 text-center">
+      <div className="mb-6 relative w-24 h-24">
+        <Image
+          src="/logo.png"
+          alt="Waveform Logo"
+          fill
+          className="object-contain"
+          priority
+        />
+      </div>
+      <h1 className="text-4xl font-extrabold tracking-tight text-accent mb-2">
+        Waveform
+      </h1>
+      <p className="max-w-md">
+        The basic framework has been successfully set up!
+      </p>
+    </main>
+  );
+}

app/globals.css

@@ -0,0 +1,21 @@
+@import "tailwindcss";
+
+@theme {
+  --color-background: hsl(200 6% 10%);
+  --color-foreground: hsl(210 5% 86%);
+
+  --color-accent: hsl(235 86% 65%);
+
+  --font-sans:
+    system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, Helvetica,
+    Arial, sans-serif;
+}
+
+@layer base {
+  body {
+    @apply bg-background text-foreground font-sans antialiased;
+    font-size: 1rem;
+    -webkit-font-smoothing: antialiased;
+    -moz-osx-font-smoothing: grayscale;
+  }
+}

app/layout.tsx

@@ -0,0 +1,33 @@
+/**
+ * @file app/layout.tsx
+ * @description Root layout component that wraps the entire application, providing global CSS styles, base HTML structure, and page metadata.
+ */
+
+import "./globals.css";
+
+/**
+ * Global application metadata configuration.
+ */
+export const metadata = {
+  title: "Waveform",
+  description: "Realtime Chat Application",
+};
+
+/**
+ * Root layout component serving as the top-level wrapper for all pages.
+ *
+ * @param {Object} props - The component props.
+ * @param {React.ReactNode} props.children - The child nodes to be rendered within the main layout wrapper.
+ * @returns {JSX.Element} The root HTML document structure.
+ */
+export default function RootLayout({
+  children,
+}: {
+  children: React.ReactNode;
+}) {
+  return (
+    <html lang="en">
+      <body className="min-h-screen flex flex-col">{children}</body>
+    </html>
+  );
+}

eslint.config.mjs

@@ -0,0 +1,18 @@
+import { defineConfig, globalIgnores } from "eslint/config";
+import nextVitals from "eslint-config-next/core-web-vitals";
+import nextTs from "eslint-config-next/typescript";
+
+const eslintConfig = defineConfig([
+  ...nextVitals,
+  ...nextTs,
+  // Override default ignores of eslint-config-next.
+  globalIgnores([
+    // Default ignores of eslint-config-next:
+    ".next/**",
+    "out/**",
+    "build/**",
+    "next-env.d.ts",
+  ]),
+]);
+
+export default eslintConfig;

next.config.ts

@@ -0,0 +1,20 @@
+/**
+ * @file next.config.ts
+ * @description Next.js framework configuration file defining standalone output builds, image optimizations, and Turbopack root settings.
+ */
+
+import path from "path";
+
+/** @type {import('next').NextConfig} */
+const nextConfig = {
+  output: "standalone" as const,
+  trailingSlash: false,
+  images: {
+    unoptimized: true,
+  },
+  turbopack: {
+    root: path.resolve(__dirname),
+  },
+};
+
+export default nextConfig;

package.json

@@ -0,0 +1,26 @@
+{
+  "name": "waveform",
+  "version": "0.1.0",
+  "private": true,
+  "scripts": {
+    "dev": "next dev",
+    "build": "next build",
+    "start": "next start",
+    "lint": "eslint"
+  },
+  "dependencies": {
+    "next": "16.3.3",
+    "react": "^19.2.8",
+    "react-dom": "^19.2.8"
+  },
+  "devDependencies": {
+    "@tailwindcss/postcss": "^4.3.3",
+    "@types/node": "^20",
+    "@types/react": "^19",
+    "@types/react-dom": "^19",
+    "eslint": "^9",
+    "eslint-config-next": "16.3.3",
+    "tailwindcss": "^4.3.3",
+    "typescript": "^5"
+  }
+}

postcss.config.mjs

@@ -0,0 +1,7 @@
+const config = {
+  plugins: {
+    "@tailwindcss/postcss": {},
+  },
+};
+
+export default config;

tsconfig.json

@@ -0,0 +1,34 @@
+{
+  "compilerOptions": {
+    "target": "ES2017",
+    "lib": ["dom", "dom.iterable", "esnext"],
+    "allowJs": true,
+    "skipLibCheck": true,
+    "strict": true,
+    "noEmit": true,
+    "esModuleInterop": true,
+    "module": "esnext",
+    "moduleResolution": "bundler",
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "jsx": "react-jsx",
+    "incremental": true,
+    "plugins": [
+      {
+        "name": "next"
+      }
+    ],
+    "paths": {
+      "@/*": ["./*"]
+    }
+  },
+  "include": [
+    "next-env.d.ts",
+    "**/*.ts",
+    "**/*.tsx",
+    ".next/types/**/*.ts",
+    ".next/dev/types/**/*.ts",
+    "**/*.mts"
+  ],
+  "exclude": ["node_modules"]
+}