Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/manmeetsinghjohal/gitnote

Your all-in-one solution for developers, designed to be their second brain, a comprehensive learning tool, and an efficient progress tracker. Seamlessly capture and organise knowledge, set & track learning goals, and monitor study habits with ease. GitNote empowers developers to enhance their productivity & knowledge management skills effortlessly.
https://github.com/manmeetsinghjohal/gitnote

auth0 clerk mongodb mongoose nextjs14 react react-hook-form tailwind typescript zod

Last synced: 30 days ago
JSON representation

Host: GitHub
URL: https://github.com/manmeetsinghjohal/gitnote
Owner: ManmeetSinghJohal
License: mit
Created: 2024-02-26T12:06:16.000Z (9 months ago)
Default Branch: main
Last Pushed: 2024-07-04T23:23:49.000Z (4 months ago)
Last Synced: 2024-10-09T19:02:46.280Z (30 days ago)
Topics: auth0, clerk, mongodb, mongoose, nextjs14, react, react-hook-form, tailwind, typescript, zod
Language: TypeScript
Homepage: https://gitnote-six.vercel.app
Size: 556 KB
Stars: 0
Watchers: 1
Forks: 0
Open Issues: 0
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

README

# GitNote

This is a [Next.js](https://nextjs.org/) project bootstrapped with [`create-next-app`](https://github.com/vercel/next.js/tree/canary/packages/create-next-app).

This project uses [`next/font`](https://nextjs.org/docs/basic-features/font-optimization) to automatically optimize and load Inter, a custom Google Font.

## 📋 Table of Contents

1. 🌐 [Demo](#demo)
2. 🤖 [Introduction](#introduction)
3. 📝 [Description](#description)
4. ⚙️ [Tech Stack](#tech-stack)
5. 🔋 [Features](#features)
6. 🛠️ [Setup](#setup)
7. 🔍 [Usage](#usage)
8. ✅ [To-do](#todo)
9. 📜 [Credits](#credits)
10. 📚 [References](#references)
11. 📞 [Contact](#contact)
12. 📋 [License](#license)

## 🌐 Demo
Here is a working live demo: [GitNote](https://gitnote-six.vercel.app/)

## 🤖 Introduction
GitNote - Your all-in-one solution for developers, designed to be their second brain, a comprehensive learning tool, and an efficient progress tracker. Seamlessly capture and organise knowledge, set and track learning goals, and monitor study habits with ease. GitNote empowers developers to enhance their productivity and knowledge management skills effortlessly.

## 📝 Description
Welcome to my project! Here, I'll provide you with a brief overview of what inspired me to create it, why it solves a problem, and what I've learned throughout its development.
- Motivation: I was motivated to build this project to address a specific issue and to enhance my coding skills.
- Why I Built This Project: My main goal was to create a practical and user-friendly solution to a real-world problem.
- Problem Solved: This project aims to simplify a particular task, making it more efficient and accessible.
- What I Learned: Throughout the development process, I gained valuable insights into various technologies and programming concepts.

## ⚙️ Tech Stack

- Next.js
- TypeScript
- Prism.js
- TinyMCE
- MongoDB
- Shadcn
- Tailwind CSS
- Mongoose ORM
- Clerk
- AuthO
- React-Hook form
- Zod

## 🔋 Features

👉 **Authentication & Onboarding**: Seamlessly log in or sign up and personalize your experience with smooth onboarding.

👉 **Profile Management**: Easily update profile details and link social media accounts for enhanced connectivity.

👉 **Creating Learning Posts**: Document knowledge, components, or workflows effortlessly, enriched with resources and links.

👉 **Related Posts**: Connect related content seamlessly for improved information accessibility.

👉 **Tagging for Context**: Enhance post context and retrieval efficiency with intuitive tagging.

👉 **Contribution Grid**: Track progress visually as the grid dynamically updates with each post similar to Github.

👉 **Goals & Experience Tracking**: Monitor and reflect on learning goals conveniently from your profile.

👉 **Search & Filter**: Retrieve past notes and tutorials swiftly with global search and filtering.

👉 **Post Collection**: Explore content easily with pagination features, witnessing your learning progression firsthand.

👉 **Responsive**: Ensures seamless functionality and aesthetics across all devices and many more, including code architecture and reusability

## 🛠️ Setup Project
To get this project up and running in your development environment, follow these step-by-step instructions.

### 🍴 Prerequisites

We need to install or make sure that these tools are pre-installed on your machine:

- [NodeJS](https://nodejs.org/en/download/): It is a JavaScript runtime build.
- [Git](https://git-scm.com/downloads): It is an open source version control system.

### 🚀 Install Project

1. Clone the Repository

```bash
git clone [email protected]:ManmeetSinghJohal/gitnote.git
```

2. Install packages

```
npm install
```

3. Create a `.env` file

```bash
NEXTAUTH_URL="http://localhost:3000"
NEXTAUTH_SECRET="BPYr......"

GITHUB_ID="1621....."
GITHUB_SECRET="e1a17....."

GOOGLE_CLIENT_ID="147636175........"
GOOGLE_CLIENT_SECRET="GOCS......."

MONGODB_URL=mongodb+srv://........

MONGODB_URI=mongodb+srv://........

NEXT_PUBLIC_TINY_EDITOR_API_KEY='12kr.........'
```

4. Run the dev server.

```bash
npm run dev
```

## 🔍 Usage

### How To Use

To clone and run this application, you'll need [Git](https://git-scm.com) and [Node.js](https://nodejs.org/en/download/) (which comes with [npm](http://npmjs.com)) installed on your computer. From your command line:

```bash
# Clone this repository
$ git clone [email protected]:ManmeetSinghJohal/gitnote.git

# Go into the repository
$ cd projectname

# Install dependencies
$ npm install

# Run the app
$ npm run dev
```

> **Note**
> If you're using Linux Bash for Windows, [see this guide](https://www.howtogeek.com/261575/how-to-run-graphical-linux-desktop-applications-from-windows-10s-bash-shell/) or use `node` from the command prompt.

### ⚒️ How to Contribute
Want to contribute? Great!

To fix a bug or enhance an existing module, follow these steps:

- Fork the repo
- Create a new branch (`git checkout -b improve-feature`)
- Make the appropriate changes in the files
- Add changes to reflect the changes made
- Commit your changes (`git commit -am 'Improve feature'`)
- Push to the branch (`git push origin improve-feature`)
- Create a Pull Request

### 📩 Bug / Feature Request

If you find a bug (the website couldn't handle the query and / or gave undesired results), kindly open an issue [here](https://github.com/ManmeetSinghJohal/gitnote/issues/new) by including your search query and the expected result.

If you'd like to request a new function, feel free to do so by opening an issue [here](https://github.com/ManmeetSinghJohal/gitnote/issues/new). Please include sample queries and their corresponding results.

## ✅ To-do

Will update soon!

## 📜 Credits

None for this project.

## 📚 References

None at the moment.

## 📞 Contact Me

[![Follow us on LinkedIn](https://img.shields.io/badge/LinkedIn-ManmeetSinghJohal-blue?style=flat&logo=linkedin&logoColor=b0c0c0&labelColor=363D44)](https://www.linkedin.com/in/manmeetsinghjohal/)

## 📋 License

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)