About notion-clone

Edit Notes like in Notion.so. Full-Stack App using React/Express.

k

Published by

konstantinruge

Visit View Profile

README.md

View on GitHub

Jotion - The connected workspace where better, faster work happens.

:notebook_with_decorative_cover: Table of Contents

Folder Structure
Getting Started
Screenshots
Tech Stack
Stats
Contribute
Acknowledgements
Buy Me a Coffee
Follow Me
Learn More
Deploy on Vercel
Give A Star
Star History
Give A Star

:bangbang: Folder Structure

Here is the folder structure of this app.

notion-clone/
  |- app/
    |-- (main)/
    |-- (marketing)/
    |-- (public)/
    |-- api/
    |-- error.tsx
    |-- globals.css
    |-- layout.tsx
    |-- not-found.tsx
  |- components/
    |-- modals/
    |-- providers/
    |-- ui/
    |-- cover.tsx
    |-- editor.tsx
    |-- icon-picker.tsx
    |-- mode-toggle.tsx
    |-- search-command.tsx
    |-- single-image-dropzone.tsx
    |-- spinner.tsx
    |-- toolbar.tsx
  |- config/
    |-- index.ts
  |- convex/
    |-- _generated/
    |-- .env.example
    |-- auth.config.js
    |-- documents.ts
    |-- environment.d.ts
    |-- schema.ts
    |-- tsconfig.json
  |- hooks/
    |-- use-cover-image.tsx
    |-- use-origin.tsx
    |-- use-scroll-top.tsx
    |-- use-search.tsx
    |-- use-settings.tsx
  |- lib/
    |-- edgestore.ts
    |-- utils.ts
  |- public/
  |- .env.example
  |- .env/.env.local
  |- .eslintrc.json
  |- .gitignore
  |- bun.lock
  |- components.json
  |- environment.d.ts
  |- next.config.js
  |- package.json
  |- postcss.config.js
  |- tailwind.config.ts
  |- tsconfig.json
  |- vercel.ts

:toolbox: Getting Started

Make sure Git and NodeJS is installed.
Clone this repository to your local computer.
Create .env.local file in root and convex directory.
Contents of .env.local:

# .env.local

# disabled next.js telemetry
NEXT_TELEMETRY_DISABLED=1

# deployment used by `npx convex dev`
CONVEX_DEPLOYMENT=dev:<deployment-name> # team: <team-name>, project: <project-name>

# convex public url
NEXT_PUBLIC_CONVEX_URL="<your-convex-url>"

# clerk auth keys
NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY=pk_test_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
CLERK_SECRET_KEY=sk_test_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

# edge store keys
EDGE_STORE_ACCESS_KEY=XXXXXXXXXXXXXXXXXXXXXXXXXXXXX
EDGE_STORE_SECRET_KEY=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

Contents of convex/.env.local:

# convex/.env.local

# clerk issuer url (go to your clerk dashboard > JWT Templates > New template > Convex > Save and copy your Issuer URL)
CLERK_ISSUER_URL=<your-clerk-issuer-url>

Convex Deployment

Visit the Convex website: https://convex.dev
Log in to your Convex account or sign up if you don't have one.
Once logged in, navigate to the "Deployments" section.
Create a new deployment or select an existing one.
Replace <deployment-name>, <team-name>, and <project-name> in the .env.local file with your Convex deployment details.
In the Convex dashboard, find the public URL associated with your deployment.
Replace <your-convex-url> in the .env.local file with your Convex public URL.

Clerk Authentication Keys

Visit the Clerk dashboard: https://clerk.dev
Log in to your Clerk account or sign up if you don't have one.
Go to the "Projects" section and select your project.
Navigate to the "API Keys" tab.
Copy the "Publishable Key" and replace <your-clerk-publishable-key> in the .env.local file with the copied key.
Copy the "Secret Key" and replace <your-clerk-secret-key> in the .env.local file with the copied key.
Go to your Clerk dashboard > JWT Templates > New template > Convex > Save and copy your Issuer URL.
Replace <your-clerk-issuer-url> with the url that you copied.
Also, go to Convex dashboard > Settings > Environment Variables > Add CLERK_ISSUER_URL variable with value that you copied.

Edge Store Keys

If you are using an Edge Store service, navigate to the respective dashboard or service provider.
Obtain the "Access Key" and "Secret Key" for your Edge Store.
Replace <your-edge-store-access-key> and <your-edge-store-secret-key> in the .env.local file with your Edge Store keys.

Open terminal in root directory. Run npm install --legacy-peer-deps or yarn install --legacy-peer-deps.
Now app is fully configured 👍 and you can start using this app using either one of npm run dev or yarn dev in one tab and npx convex dev in another tab.

NOTE: Please make sure to keep your API keys and configuration values secure and do not expose them publicly.

:camera: Screenshots:

Modern UI/UX

Create new pages

Notion-styled editor

Search pages

:gear: Tech Stack

:wrench: Stats

:raised_hands: Contribute

You might encounter some bugs while using this app. You are more than welcome to contribute. Just submit changes via pull request and I will review them before merging. Make sure you follow community guidelines.