Initial commit

Author: AmmarMohammed01

.env.example

@@ -0,0 +1,5 @@
+DATABASE_URL=file:./dev.db
+BETTER_AUTH_SECRET=
+BETTER_AUTH_URL=http://localhost:3000
+EMAIL_USER=
+EMAIL_PASS=""

.gemini/settings.json

@@ -0,0 +1,13 @@
+{
+  "mcpServers": {
+    "nuxt-remote": {
+      "httpUrl": "https://nuxt.com/mcp"
+    },
+    "nuxt-ui-remote": {
+      "httpUrl": "https://ui.nuxt.com/mcp"
+    },
+    "better-auth": {
+      "httpUrl": "https://mcp.chonkie.ai/better-auth/better-auth-builder/mcp"
+    }
+  }
+}

.github/workflows/main.yml

@@ -0,0 +1,40 @@
+name: Build and Publish Docker Image
+
+on:
+  push:
+    branches:
+      - main
+
+jobs:
+  build:
+    permissions:
+      id-token: write # This is required for requesting the JWT
+    runs-on: ubuntu-24.04-arm
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v3
+
+      # - name: Set up Docker Buildx
+      #  uses: docker/setup-buildx-action@v1
+
+      - name: configure aws credentials
+        uses: aws-actions/configure-aws-credentials@v4
+        with:
+          role-to-assume: arn:aws:iam::654654236858:role/GithubActions
+          role-session-name: GitHub_to_AWS_via_FederatedOIDC
+          aws-region: us-east-2
+
+      - name: Login to Amazon ECR
+        id: login-ecr
+        uses: aws-actions/amazon-ecr-login@v2
+
+      - name: Build and Push Docker image
+        env:
+          ECR_REGISTRY: ${{ steps.login-ecr.outputs.registry}}
+          REPOSITORY: nuxt-template
+          IMAGE_TAG: ${{ github.sha}}
+          DATABASE_URL: "file:./dev.db"
+        run: |
+          docker build --output type=image,push=true --platform linux/arm64 -t $ECR_REGISTRY/$REPOSITORY:$IMAGE_TAG .
+          docker build --output type=image,push=true --platform linux/arm64 -t $ECR_REGISTRY/$REPOSITORY:prod .

.gitignore

@@ -0,0 +1,28 @@
+# Nuxt dev/build outputs
+.output
+.data
+.nuxt
+.nitro
+.cache
+dist
+
+# Node dependencies
+node_modules
+
+# Logs
+logs
+*.log
+
+# Misc
+.DS_Store
+.fleet
+.idea
+
+# Local env files
+.env
+.env.*
+!.env.example
+
+/prisma/generated
+/prisma/migrations
+/dev.db

.npmrc

@@ -0,0 +1 @@
+shamefully-hoist=true

.prettierignore

@@ -0,0 +1,20 @@
+# Package managers and build outputs
+node_modules
+.nuxt
+.output
+dist
+
+# Prisma and Database
+prisma/migrations
+*.db
+*.db-journal
+
+# Version control
+.git
+
+# Public assets (often minified or binary)
+public/
+
+# Environment files
+.env
+.env.*

.prettierrc

@@ -0,0 +1,12 @@
+{
+  "semi": false,
+  "singleQuote": true,
+  "tabWidth": 2,
+  "trailingComma": "es5",
+  "printWidth": 100,
+  "bracketSpacing": true,
+  "arrowParens": "always",
+  "endOfLine": "lf",
+  "vueIndentScriptAndStyle": true,
+  "plugins": ["prettier-plugin-tailwindcss"]
+}

README.md

@@ -0,0 +1,107 @@
+# Nuxt Template (Better Auth + Prisma + SQLite)
+
+A modern, production-ready Nuxt 4 template featuring a robust authentication system, ORM integration, and a clean UI foundation.
+
+## Features
+
+- **Nuxt 4**: The latest and greatest from the Nuxt team.
+- **Better Auth**: Comprehensive authentication with **Email OTP** support.
+- **Prisma**: Type-safe ORM for interacting with the database.
+- **SQLite**: Lightweight, zero-configuration database, ideal for development and small-to-medium projects.
+- **Nuxt UI v3**: Beautiful, accessible, and customizable UI components built with Tailwind CSS.
+- **Nodemailer**: Pre-configured for sending verification emails via Gmail.
+
+## Stack
+
+- **Framework**: [Nuxt](https://nuxt.com/)
+- **Auth**: [Better Auth](https://www.better-auth.com/)
+- **ORM**: [Prisma](https://www.prisma.io/)
+- **Database**: [SQLite](https://sqlite.org/)
+- **UI Framework**: [Nuxt UI](https://ui3.nuxt.com/)
+- **Email**: [Nodemailer](https://nodemailer.com/)
+
+## Getting Started
+
+### 1. Clone the repository
+
+```bash
+git clone <your-repo-url>
+cd nuxt-template
+```
+
+### 2. Install dependencies
+
+This project uses `pnpm`, but you can use `npm` as well.
+
+```bash
+pnpm install
+```
+
+### 3. Setup Environment Variables
+
+Copy the example environment file and fill in your details.
+
+```bash
+cp .env.example .env
+```
+
+Open `.env` and configure the following:
+
+- `DATABASE_URL`: The SQLite connection string (default: `file:./dev.db`).
+- `BETTER_AUTH_SECRET`: A secure random string for encryption. You can generate one using `openssl rand -hex 32`.
+- `BETTER_AUTH_URL`: The base URL of your application (default: `http://localhost:3000`).
+- `EMAIL_USER`: Your Gmail address (for OTP delivery).
+- `EMAIL_PASS`: Your Gmail App Password. [How to generate an App Password](https://support.google.com/accounts/answer/185833).
+
+### 4. Database Setup
+
+Initialize your SQLite database and run migrations.
+
+```bash
+pnpm dlx prisma migrate dev --name init
+```
+
+Generate the Prisma client
+
+```bash
+pnpm dlx prisma generate
+```
+
+To reset the database and run the seed script:
+
+```bash
+pnpm prisma:reset
+```
+
+### 5. Start the development server
+
+```bash
+pnpm dev
+```
+
+Your application will be available at `http://localhost:3000`. This command also starts **Prisma Studio** automatically.
+
+### 6. How to Login
+
+Login requires an email address that already exists in the database.
+
+- **Option A: Use the seeded user**
+  Go to `/auth` and log in with `alice@a.com`.
+- **Option B: Use your own email**
+  Update `prisma/seed.ts` with your email, then run `pnpm prisma:reset` to re-seed.
+
+**To get your OTP:**
+
+- Check your configured email inbox.
+- **Or**, check the **Prisma Studio** tab in your browser and look in the `Verification` table.
+
+## Project Structure
+
+- `app/`: Frontend code (pages, components, assets, composables).
+- `server/`: Backend code (API routes, authentication logic, database utilities).
+- `prisma/`: Database schema, migrations, and seed scripts.
+- `public/`: Static assets.
+
+## License
+
+MIT

app/app.vue

@@ -0,0 +1,41 @@
+<script setup lang="ts">
+const colorMode = useColorMode()
+
+const isDark = computed({
+  get () {
+    return colorMode.value === 'dark'
+  },
+  set () {
+    colorMode.preference = colorMode.value === 'dark' ? 'light' : 'dark'
+  }
+})
+</script>
+
+<template>
+  <UApp>
+    <div class="min-h-screen flex flex-col bg-white dark:bg-gray-900 text-gray-900 dark:text-gray-100 transition-colors duration-300">
+      <header class="border-b border-gray-200 dark:border-gray-800 bg-white/75 dark:bg-gray-900/75 backdrop-blur-md sticky top-0 z-50">
+        <UContainer class="flex items-center justify-between h-16">
+          <NuxtLink to="/" class="text-xl font-bold flex items-center gap-2">
+            <UIcon name="i-heroicons-cube-transparent" class="w-8 h-8 text-primary-500" />
+            <span>Nuxt Template</span>
+          </NuxtLink>
+          
+          <div class="flex items-center gap-2">
+            <UButton
+              :icon="isDark ? 'i-heroicons-moon-20-solid' : 'i-heroicons-sun-20-solid'"
+              color="neutral"
+              variant="ghost"
+              @click="isDark = !isDark"
+              aria-label="Toggle Theme"
+            />
+          </div>
+        </UContainer>
+      </header>
+
+      <main class="flex-1">
+        <NuxtPage />
+      </main>
+    </div>
+  </UApp>
+</template>

app/assets/css/main.css

@@ -0,0 +1,3 @@
+@import "tailwindcss";
+@import "@nuxt/ui";
+