Skip to content

sankha1545/Bookmark-fullstack-app

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

60 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

πŸš€ Smart Bookmark – Fullstack SaaS Platform

Smart Bookmark is a production-grade, SaaS-style bookmark management platform built with modern full-stack architecture.

This monorepo contains:

Designed with scalability, security, and enterprise-level architecture in mind.


πŸ“Έ Gallery

Hero

Hero

Security

Security

CTA

CTA

About

About

🌍 Live Architecture Overview

Smart Bookmark follows a multi-application SaaS architecture:

                      β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
                      β”‚        Supabase          β”‚
                      β”‚  Postgres + Auth + RLS   β”‚
                      β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
                                    β”‚
     β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”Όβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
     β”‚                              β”‚                              β”‚
     β”‚                              β”‚                              β”‚
β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”     β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”           β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚   Client App      β”‚     β”‚    Admin App      β”‚           β”‚    API Routes     β”‚
β”‚  (Next.js 16)     β”‚     β”‚  (Next.js 16)     β”‚           β”‚  (Server-side)    β”‚
β”‚                   β”‚     β”‚                   β”‚           β”‚                   β”‚
β”‚ - Bookmark CRUD   β”‚     β”‚ - User Management β”‚           β”‚ - Analytics       β”‚
β”‚ - Realtime Sync   β”‚     β”‚ - Dashboard Stats β”‚           β”‚ - Secure Queries  β”‚
β”‚ - Google OAuth    β”‚     β”‚ - Contact Mgmt    β”‚           β”‚ - Role Control    β”‚
β”‚ - Analytics       β”‚     β”‚ - System Insights β”‚           β”‚                   β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜     β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜           β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜

πŸ“‚ Monorepo Structure

Bookmark-fullstack-app/
β”‚
β”œβ”€β”€ client-app/        β†’ End-user SaaS dashboard
β”œβ”€β”€ admin-app/         β†’ Master admin control panel
β”‚
β”œβ”€β”€ README.md          β†’ (You are here)
└── package.json       (optional root config)

πŸ§‘β€πŸ’» Applications


πŸ”– 1. Client Application

The Client App allows users to:

  • Save, edit, delete bookmarks
  • View analytics
  • Experience real-time updates
  • Authenticate via Google OAuth
  • Use a fully responsive dashboard

πŸ”— Client App Documentation

πŸ‘‰ Client App README


πŸ›‘οΈ 2. Admin Application

The Admin App provides:

  • Master admin authentication
  • User management
  • Analytics dashboard
  • Contact message monitoring
  • Role-based access control
  • Secure server-side APIs

πŸ”— Admin App Documentation

πŸ‘‰ Admin App README


πŸ—οΈ Full System Architecture

🧩 Technology Stack

Layer Technology
Frontend Next.js 16 (App Router)
Language TypeScript
Styling Tailwind CSS
UI Library ShadCN UI
Backend Supabase
Database PostgreSQL
Auth Supabase Auth + OAuth
Security RLS Policies
Deployment Vercel

πŸ” Security Architecture

Smart Bookmark is built with strong SaaS-grade security:

  • Row-Level Security (RLS)
  • Secure Supabase policies
  • Role-based access control
  • Protected server routes
  • Secure environment variables
  • Admin JWT session management
  • Brute-force login protection (Admin App)

πŸ”„ Data Flow Diagram

User β†’ Client App β†’ Supabase Auth
              ↓
    Postgres (RLS enforced)
              ↓
    Real-time subscription
              ↓
    UI auto-update (React state)

Admin flow:

Admin β†’ Admin App β†’ Secure API Route β†’ Supabase Service Role
                                              ↓
                                          Database

βš™οΈ Development Setup

Clone repository:

git clone https://github.com/sankha1545/Bookmark-fullstack-app.git
cd Bookmark-fullstack-app

πŸ–₯️ Running Client App

cd client-app
npm install
npm run dev

Runs on:

http://localhost:3000

πŸ›‘οΈ Running Admin App

cd admin-app
npm install
npm run dev

Runs on:

http://localhost:3001 (or configured port)

🌎 Deployment Strategy

Both apps are deployed separately on Vercel:

  • Client β†’ client-bookmark.vercel.app
  • Admin β†’ admin-bookmark.vercel.app

Each project has isolated environment variables.


🎯 Design Philosophy

This platform is built with:

  • Modular folder architecture
  • Clean separation of concerns
  • Enterprise-ready security
  • SaaS-grade UI/UX
  • Scalable backend design
  • Production-level coding standards

This is not a tutorial project β€” it is structured like a real startup SaaS.


πŸ“ˆ Future Roadmap

  • AI-powered bookmark tagging
  • Folder & team collaboration
  • Bookmark sharing
  • Admin audit logs
  • Advanced analytics dashboard
  • System health monitoring

πŸ‘¨β€πŸ’» Author

Sankha Subhra Das
Full Stack Developer
Next.js β€’ Supabase β€’ TypeScript β€’ SaaS Architecture

πŸ“œ License

This project is built for portfolio and educational demonstration purposes.

About

A modern full-stack SaaS bookmark platform built with Next.js and Supabase, featuring a real-time client dashboard and a secure role-based admin portal.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors