Skip to content

bcheban/next-noteforge

Repository files navigation

NoteForge Logo

NoteForge

A full-stack note-taking platform with auth, advanced search, and persistent storage — built with Next.js App Router, Drizzle, and NeonDB.

🔗 Live Demo | 💻 GitHub Repo


📌 Project Overview

NoteForge is a full-stack notes app aimed at developers. It supports user authentication, fuzzy / full-text search across notes, and durable cloud storage. Built on Next.js with the App Router, server actions, and TypeScript end-to-end. Data lives in NeonDB (Postgres) accessed via the Drizzle ORM. UI components come from ShadCN with TailwindCSS.


🌐 Live Preview

👉 https://next-noteforge.vercel.app


🛠 Technologies Used

Core Framework

Next.js TypeScript

Database & ORM

NeonDB Drizzle ORM PostgreSQL

UI & Styling

ShadCN TailwindCSS

Deployment

Vercel


⚙️ Getting Started

📋 Prerequisites

  • Node.js v20.x or higher
  • npm v10.x or higher
  • A NeonDB Postgres connection string

📦 Installation

  1. Clone the repository:

    git clone https://github.com/bcheban/next-noteforge.git
    cd next-noteforge
  2. Install dependencies:

    npm install
  3. Configure environment: create .env.local with your NeonDB URL and auth secrets (see .env.example).

  4. Start the dev server:

    npm run dev

    The app will open at http://localhost:3000.

🧰 Available Scripts

Script Description
npm run dev Start the Next.js dev server
npm run build Production build
npm start Run the production server
npm run lint Run ESLint
npm run db:push Push Drizzle schema to NeonDB

🚀 Features

  • 🔐 Authentication – Sign in / sign up with persistent sessions.
  • 📝 Rich Notes – Create, edit, and delete personal notes.
  • 🔎 Advanced Search – Filter notes across title and body.
  • ☁️ Cloud Storage – Notes persisted to NeonDB via Drizzle.
  • 🧱 App Router Architecture – Server components + server actions.
  • 🌗 Light / Dark Theme – Theme-aware ShadCN components.
  • 📱 Fully Responsive – Works seamlessly on mobile and desktop.

📊 Lighthouse

Lighthouse mobile scores Lighthouse desktop scores


Made with ❤️ by @bcheban

About

Simple notes app for devs

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors