{"id":15723437,"url":"https://github.com/mo-hassann/nextjs-notes-app","last_synced_at":"2026-02-05T00:35:02.218Z","repository":{"id":246711451,"uuid":"821751829","full_name":"mo-hassann/nextjs-notes-app","owner":"mo-hassann","description":"this is simple notes app with next js, hono, cleark-auth, react-query and drizzle orm","archived":false,"fork":false,"pushed_at":"2024-08-26T12:12:04.000Z","size":561,"stargazers_count":4,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-07-09T14:49:07.924Z","etag":null,"topics":["cleark","drizzle","hono","nextjs","note","notes","notes-app","notes-keeper","notesapp","react-query","shadcn-ui","tanstack-react-query","todo","todoapp","todoapp-react","typescript"],"latest_commit_sha":null,"homepage":"https://notes-app-s.vercel.app","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mo-hassann.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-06-29T10:33:21.000Z","updated_at":"2025-06-30T01:02:16.000Z","dependencies_parsed_at":null,"dependency_job_id":"ae405526-8e40-42a2-8c17-235befb818b4","html_url":"https://github.com/mo-hassann/nextjs-notes-app","commit_stats":null,"previous_names":["mo-hassann/todo-app","mo-hassann/simple-notes-app"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/mo-hassann/nextjs-notes-app","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mo-hassann%2Fnextjs-notes-app","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mo-hassann%2Fnextjs-notes-app/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mo-hassann%2Fnextjs-notes-app/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mo-hassann%2Fnextjs-notes-app/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mo-hassann","download_url":"https://codeload.github.com/mo-hassann/nextjs-notes-app/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mo-hassann%2Fnextjs-notes-app/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29103408,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-04T22:44:52.815Z","status":"ssl_error","status_checked_at":"2026-02-04T22:44:16.428Z","response_time":62,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cleark","drizzle","hono","nextjs","note","notes","notes-app","notes-keeper","notesapp","react-query","shadcn-ui","tanstack-react-query","todo","todoapp","todoapp-react","typescript"],"created_at":"2024-10-03T22:11:37.924Z","updated_at":"2026-02-05T00:35:02.192Z","avatar_url":"https://github.com/mo-hassann.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Next Js Notes App\n\n![alt text](https://github.com/mo-hassann/notes-app/blob/main/public/app-picture.png)\n\n\nA feature-rich notes application built with Next.js, Hono, Clerk for authentication, React Query for data fetching, and Drizzle ORM for database management. This app allows users to create, edit, delete, and categorize notes easily.\n\n## Table of Contents\n\n- [Features](#-features)\n- [Tech Stack](#-tech-stack)\n- [Getting Started](#-getting-started)\n- [Installation](#-installation)\n- [Usage](#-usage)\n- [Contributing](#-contributing)\n- [License](#-license)\n\n## ✨ Features\n\n- **User Authentication**: Secure authentication using Clerk, allowing users to sign up, log in, and manage their accounts.\n- **Create, Edit, and Delete Notes**: Users can easily create, edit, or delete their notes.\n- **Categorize Notes**: Classify notes under different categories for better organization.\n- **Real-time Data**: Data is fetched and updated in real-time using React Query, ensuring the UI is always in sync with the backend.\n- **Responsive Design**: The application is fully responsive and works seamlessly on all devices.\n\n## 🛠️ Tech Stack\n\n- **Next.js**: A React framework for building server-side rendering and static web applications.\n- **Hono**: A lightweight web framework for building server-side applications with TypeScript.\n- **Clerk**: Authentication service for managing user identities, including sign-up and login.\n- **React Query**: A data-fetching library for managing server-state in React applications.\n- **Drizzle ORM**: TypeScript-first ORM for type-safe database access.\n\n## 📦 Getting Started\n\nTo get a local copy of this project up and running, follow these steps.\n\n### Prerequisites\n\n- **Node.js** (v16.x or higher) and **npm** or **yarn**.\n- **Bun**: If you prefer using Bun for package management and running scripts.\n- **PostgreSQL** (or another supported SQL database).\n\n### 🚀 Installation\n\n1. **Clone the repository:**\n\n    ```bash\n    git clone https://github.com/mo-hassann/nextjs-notes-app.git\n    cd nextjs-notes-app\n    ```\n\n2. **Install dependencies:**\n\n    Using npm:\n\n    ```bash\n    npm install\n    ```\n\n    Using yarn:\n\n    ```bash\n    yarn install\n    ```\n\n    Using Bun:\n\n    ```bash\n    bun install\n    ```\n\n3. **Set up environment variables:**\n\n    Create a `.env` file in the root directory and add the following variables:\n\n    ```env\n    # next\n    NEXT_PUBLIC_APP_URL=http://localhost:3000\n\n    # cleark auth\n    NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY=************\n    CLERK_SECRET_KEY=***********\n\n    NEXT_PUBLIC_CLERK_SIGN_IN_URL=/sign-in\n    NEXT_PUBLIC_CLERK_SIGN_UP_URL=/sign-up\n\n    #hono with clerk\n    CLERK_PUBLISHABLE_KEY=**************\n\n    # database\n    DATABASE_URL=https://**************\n    DATABASE_SECRET=************************\n    DRIZZLE_DATABASE_URL=postgresql://*******:*********************\n    ```\n\n4. **Run database migrations:**\n\n    Ensure your database is running and then run:\n\n    Using npm or yarn:\n\n    ```bash\n    npm run migrate\n    # or\n    yarn migrate\n    ```\n\n    Using Bun:\n\n    ```bash\n    bun run migrate\n    ```\n\n5. **Start the development server:**\n\n    Using npm or yarn:\n\n    ```bash\n    npm run dev\n    # or\n    yarn dev\n    ```\n\n    Using Bun:\n\n    ```bash\n    bun dev\n    ```\n\n    Open [http://localhost:3000](http://localhost:3000) to view the app in your browser.\n\n## 📖 Usage\n\n### Running the app\n\n- **Development mode:** `npm run dev`, `yarn dev`, or `bun dev`.\n- **Production mode:** `npm run build \u0026\u0026 npm start`, `yarn build \u0026\u0026 yarn start`, or `bun run build \u0026\u0026 bun start`.\n\n### API Documentation\n\nThe API documentation for this application is available at [http://localhost:3000/api/docs](http://localhost:3000/api/docs). It details all endpoints and their usage.\n\n## 🤝 Contributing\n\nWe welcome contributions to this project. Please follow these steps to contribute:\n\n1. **Fork the repository.**\n2. **Create a new branch** (`git checkout -b feature/your-feature-name`).\n3. **Make your changes** and commit them (`git commit -m 'Add some feature'`).\n4. **Push to the branch** (`git push origin feature/your-feature-name`).\n5. **Open a pull request**.\n\nPlease make sure to update tests as appropriate.\n\n## 📜 License\n\nDistributed under the MIT License. See [License](/LICENSE) for more information.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmo-hassann%2Fnextjs-notes-app","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmo-hassann%2Fnextjs-notes-app","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmo-hassann%2Fnextjs-notes-app/lists"}