https://github.com/abidalwassie/next-blog

A modern, full-stack blogging platform with custom wildcard domains. example: yoursite.frostcore.tech
https://github.com/abidalwassie/next-blog

backend blog multi-tenant next-auth nextjs postgresql prisma react shadcn-ui subdomain tailwindcss typescript wildcard-domains

Last synced: over 1 year ago
JSON representation

A modern, full-stack blogging platform with custom wildcard domains. example: yoursite.frostcore.tech

• Host: GitHub
• URL: https://github.com/abidalwassie/next-blog
• Owner: AbidAlWassie
• License: mit
• Created: 2025-03-01T13:29:04.000Z (over 1 year ago)
• Default Branch: master
• Last Pushed: 2025-03-03T09:57:26.000Z (over 1 year ago)
• Last Synced: 2025-03-03T10:24:51.184Z (over 1 year ago)
• Topics: backend, blog, multi-tenant, next-auth, nextjs, postgresql, prisma, react, shadcn-ui, subdomain, tailwindcss, typescript, wildcard-domains
• Language: TypeScript
• Homepage: https://frostcore.tech
• Size: 173 KB
• Stars: 1
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

          
# 🚀 Next Blog - Multi-Tenant Blogging Platform

A modern, full-stack blogging platform built with **Next.js**, **Prisma**, **PostgreSQL**, and **TypeScript**. This platform allows users to create and manage multiple blogs, each with its own custom subdomain (e.g., `mysite.frostcore.tech`). Perfect for developers, content creators, and businesses looking to manage multiple blogs under one roof.

---

## 🔥 Techstack

[](https://nextjs.org/)

[](https://www.typescriptlang.org/)

[](https://www.prisma.io/)

[](https://tailwindcss.com/)

[](https://www.postgresql.org/)

[](https://next-auth.js.org/)

---

## ✨ Features

### 🏢 **Multi-Tenant Architecture**

- Create and manage multiple blogs under one account.

- Each blog gets a unique subdomain (e.g., `mysite.frostcore.tech`).

- Isolated content and settings for each blog.

### 🔐 **Authentication & Authorization**

- Secure authentication with **NextAuth.js**.

- Supports email/password, Google, and GitHub login.

- Role-based access control for managing blogs and posts.

### 📝 **Blog Management**

- Create, edit, and publish blog posts with a rich text editor.

- Save drafts and schedule posts for later.

- Manage multiple blogs from a single dashboard.

### 🎨 **Modern UI/UX**

- Built with **Tailwind CSS** and **shadcn/ui** for a sleek, responsive design.

- Dark/Light mode support.

- Customizable themes and components.

### 🛠️ **Technical Features**

- **Next.js** for server-side rendering and API routes.

- **Prisma** for database management and migrations.

- **PostgreSQL** as the primary database.

- **TypeScript** for type-safe development.

- **Turbopack** for faster builds and development.

---

## 🚀 Quick Start

### Prerequisites

- **Node.js 18+**

- **PostgreSQL** (running locally or remotely)

- **pnpm** (recommended package manager)

### Installation

1. Fork & Clone the repository:

   ```bash

   git clone https://github.com/your-username/next-blog.git

   cd next-blog

   ```

2. Install dependencies:

   ```bash

   pnpm install

   ```

3. Set up your environment variables:

   Create a `.env` file in the root directory and add the following:

   ```env

   DATABASE_URL="postgresql://username:password@localhost:5432/your_database_name?schema=public"

   GOOGLE_CLIENT_ID="your_google_client_id"

   GOOGLE_CLIENT_SECRET="your_google_client_secret"

   GITHUB_CLIENT_ID="your_github_client_id"

   GITHUB_CLIENT_SECRET="your_github_client_secret"

   NEXTAUTH_URL="http://localhost:3000" or "your_domain.com" for production

   NEXTAUTH_SECRET="run: npx auth secret or run: openssl rand -base64 32"

   RESEND_API_KEY="your_resend_api_key"

   # EMAIL_SERVER_PASSWORD="your_resend_api_key" same as RESEND_API_KEY

   EMAIL_SERVER_USER=resend

   EMAIL_SERVER_HOST=smtp.resend.com

   EMAIL_SERVER_PORT=465

   EMAIL_FROM=onboarding@resend.dev

   BASE_DOMAIN="localhost:3000" # for development

   # BASE_DOMAIN="your_domain.com" # for production

   PROTOCOL="http://" # for development

   # PROTOCOL="https://" # for production

   ```

4. Run database migrations:

   ```bash

   pnpm prisma migrate dev --name init

   ```

5. Seed the database (optional):

   ```bash

   pnpm seed

   ```

6. Start the development server:

   ```bash

   pnpm dev

   ```

7. Open your browser and navigate to `http://localhost:3000`.

---

## 🛠️ Scripts

- **`pnpm dev`**: Start the development server with Turbopack.

- **`pnpm build`**: Generate Prisma client and build the project.

- **`pnpm start`**: Start the production server.

- **`pnpm lint`**: Run ESLint to check for code issues.

- **`pnpm prisma studio`**: Open Prisma Studio to visualize and edit the database.

- **`pnpm prisma generate`**: Generate the Prisma client.

- **`pnpm prisma db push`**: Push the Prisma schema state to the database.

---

## 🧩 Tech Stack

- **Frontend**: Next.js, React, Tailwind CSS, shadcn/ui

- **Backend**: Next.js API Routes, Server Actions

- **Database & Authentication**: PrismaORM, PostgreSQL, NextAuth

- **Utilities**: Zod (validation), UUID (unique IDs), Resend (email)

---

## 📂 Project Structure

```

next-blog/

├── app/                  # Next.js app router

│   └── ...

├── components/           # Reusable UI components

├── components.json       # Components configuration

├── lib/                  # Utility functions

├── middleware.ts         # Middleware configuration

├── prisma/               # Prisma schema and migrations

├── public/               # Static assets

├── README.md             # Project README file

├── styles/               # Global styles

│   └── ...

├── .env                  # Environment variables

├── .env.example          # Example env

├── .gitignore            # Git ignore file

├── next.config.ts        # Next.js configuration

├── next-env.d.ts         # Next.js environment types

├── tsconfig.json         # TypeScript configuration

├── eslint.config.mjs     # ESLint configuration

├── postcss.config.mjs    # PostCSS configuration

├── package.json          # Project dependencies

├── pnpm-lock.yaml        # pnpm lock file

```

---

## 🤝 Contributing

Contributions are welcome! If you'd like to contribute, please follow these steps:

1. Fork the repository.

2. Create a new branch (`git checkout -b feature/your-feature`).

3. Commit your changes (`git commit -m 'Add some feature'`).

4. Push to the branch (`git push origin feature/your-feature`).

5. Open a pull request.

---

## 📄 License

This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.

---

Keep blogging! 🎉