{"id":23656032,"url":"https://github.com/lostovayne/saas-notion-clone","last_synced_at":"2025-09-01T06:33:04.425Z","repository":{"id":207486333,"uuid":"719315749","full_name":"Lostovayne/SaaS-Notion-Clone","owner":"Lostovayne","description":"Complete clone of Notion, using Next version 14, Clerk as authentication system, Typescript and Tailwind for styles together with Shadcn","archived":false,"fork":false,"pushed_at":"2024-12-22T20:27:10.000Z","size":1578,"stargazers_count":7,"open_issues_count":0,"forks_count":3,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-02T11:22:37.000Z","etag":null,"topics":["clerkauth","convex","nextjs14","saas-application","tailwindcss","typescript"],"latest_commit_sha":null,"homepage":"https://www.murkiva.cloud/","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/Lostovayne.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":"2023-11-15T22:55:48.000Z","updated_at":"2025-03-18T10:07:42.000Z","dependencies_parsed_at":"2023-11-26T19:31:22.300Z","dependency_job_id":"debfde92-8d3b-48e4-8eae-08ba38586f63","html_url":"https://github.com/Lostovayne/SaaS-Notion-Clone","commit_stats":null,"previous_names":["lostovayne/clon-de-notion-con-next14-tailwind-typescript","lostovayne/saas-clon-de-notion-con-next14-tailwind-typescript","lostovayne/saas-clon-de-notion","lostovayne/saas-notion-clone"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/Lostovayne/SaaS-Notion-Clone","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Lostovayne%2FSaaS-Notion-Clone","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Lostovayne%2FSaaS-Notion-Clone/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Lostovayne%2FSaaS-Notion-Clone/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Lostovayne%2FSaaS-Notion-Clone/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Lostovayne","download_url":"https://codeload.github.com/Lostovayne/SaaS-Notion-Clone/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Lostovayne%2FSaaS-Notion-Clone/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":273082414,"owners_count":25042282,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-09-01T02:00:09.058Z","response_time":120,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":["clerkauth","convex","nextjs14","saas-application","tailwindcss","typescript"],"created_at":"2024-12-28T20:18:02.636Z","updated_at":"2025-09-01T06:33:04.385Z","avatar_url":"https://github.com/Lostovayne.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Notion Clone\n\n\u003cdiv align=\"center\"\u003e\n\n![Notion Clone Logo](https://github.com/Lostovayne/Clon-de-Notion-con-Next14-Tailwind-Typescript/assets/92962731/9fff6f52-88ff-4798-b59e-f1a8d19e84d1)\n\n[![Next.js](https://img.shields.io/badge/Next.js-14-black)](https://nextjs.org/)\n[![TypeScript](https://img.shields.io/badge/TypeScript-5.0-blue)](https://www.typescriptlang.org/)\n[![Tailwind CSS](https://img.shields.io/badge/Tailwind-3.0-38B2AC)](https://tailwindcss.com/)\n[![License](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)\n\nA powerful and modern Notion clone built with cutting-edge technologies.\n\n[Demo](your-demo-link) · [Report Bug](your-issues-link) · [Request Feature](your-issues-link)\n\n\u003c/div\u003e\n\n## Overview\n\nThis project is a feature-rich Notion clone that demonstrates the implementation of modern web technologies. Built on Next.js 14, it seamlessly integrates real-time collaboration, secure authentication, and a responsive user interface. The application leverages Clerk for authentication and Convex as a robust real-time backend, while utilizing Shadcn components and Tailwind CSS for an elegant and responsive design.\n\n## Key Features\n\n### Core Functionality\n\n- Full-featured Notion-style editor\n- Real-time database synchronization\n- Infinite nested documents\n- Secure authentication system\n- Light and dark mode support\n- **Integration of new functionalities** - New features have been added to enhance the user experience.\n\n### Document Management\n\n- File upload, replacement, and deletion\n- Soft delete with trash bin functionality\n- Document recovery system\n- Real-time document icon updates\n- Cover images for documents\n- **Document management improvements** - New options for file retrieval and management have been implemented.\n\n### User Interface\n\n- Fully collapsible sidebar\n- Responsive mobile design\n- Web publishing capabilities\n- Custom landing page\n- Modern and clean UI\n- **User interface upgrade** - Adjustments have been made to improve usability and aesthetics.\n\n## Technology Stack\n\n### Frontend\n\n- **Next.js 14** - React framework for production\n- **TypeScript** - Static type checking\n- **Tailwind CSS** - Utility-first CSS framework\n- **Shadcn** - Customizable UI components\n- **Blocknote** - A powerful and flexible framework for building modern web applications.\n\n### Backend \u0026 Services\n\n- **Convex** - Real-time backend infrastructure\n- **Clerk** - Authentication and user management\n- **Edge Runtime** - Enhanced performance and scalability\n\n## Getting Started\n\n### Prerequisites\n\n- Node.js (version 18.x.x or higher)\n- npm or yarn package manager\n- Git\n\n### Installation\n\n1. Clone the repository\n\n```bash\ngit clone https://github.com/yourusername/notion-clone.git\ncd notion-clone\n```\n\n2. Install dependencies\n\n```bash\nnpm install\n# or\nyarn install\n```\n\n3. Environment Setup\n   - Copy `.env.example` to `.env.local`\n   - Configure the following environment variables:\n\n```env\n\nCONVEX_DEPLOYMENT=\nNEXT_PUBLIC_CONVEX_URL=\nNEXT_PUBLIC_CLERK_PUBLISHABLE_KEY=\nCLERK_SECRET_KEY=\nEDGE_STORE_ACCESS_KEY=\nEDGE_STORE_SECRET_KEY=\n\n\nNEXT_PUBLIC_EDGE_STORE_ACCESS_KEY=\nNEXT_PUBLIC_EDGE_STORE_SECRET_KEY=\n\n\n```\n\n4. Start the development servers\n\n```bash\n# Start Convex backend\nnpx convex dev\n\n# In a new terminal, start Next.js\nnpm run dev\n# or\nyarn dev\n```\n\n5. Deploy Proyect to Vercel\n\n```bash\n   npm run build \u0026\u0026 npx convex deploy\n\n   # Copied and Paste env variables\n\n```\n\n## Project Structure\n\n```\nnotion-clone/\n├── app/                    # Next.js app directory\n│   ├─(main)/            # Main application routes\n│   └── (marketing)/       # Marketing pages\n├── components/            # Reusable UI components\n├── convex/                # Backend models and functions\n├── hooks/                # Custom React hooks\n├── lib/                  # Utility functions\n└── public/               # Static assets\n```\n\n## Development Guide\n\n### Adding New Features\n\n1. Backend (Convex)\n\n   - Add new models in `convex/schema.ts`\n   - Create new functions in `convex/` directory\n\n2. Frontend\n   - Create components in `components/`\n   - Add new routes in `app/(main)/(routes)/`\n   - Implement hooks in `hooks/`\n\n### Best Practices\n\n- Follow TypeScript strict mode guidelines\n- Use Tailwind CSS for styling\n- Implement responsive design patterns\n- Write clean, documented code\n- Follow the established project structure\n\n## Deployment\n\n1. Build the application\n\n```bash\nnpm run build\n# or\nyarn build\n```\n\n2. Deploy to your preferred platform\n   - Vercel (recommended)\n   - Netlify\n   - Custom server\n\n### Deployment Checklist\n\n- [ ] Configure environment variables\n- [ ] Set up Convex production deployment\n- [ ] Configure Clerk authentication\n- [ ] Set up proper domain and SSL\n- [ ] Test all features in production\n\n## Contributing\n\nWe welcome contributions! Please follow these steps:\n\n1. Fork the repository\n2. Create your feature branch (`git checkout -b feature/AmazingFeature`)\n3. Commit your changes (`git commit -m 'Add some AmazingFeature'`)\n4. Push to the branch (`git push origin feature/AmazingFeature`)\n5. Open a Pull Request\n\n## License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n## Support\n\n- Create an issue for bug reports or feature requests\n- Star the repository if you find it useful\n- Follow for updates\n\n---\n\n\u003cdiv align=\"center\"\u003e\n\nMade with ❤️ by [DeusloVuilt](your-profile-link)\n\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flostovayne%2Fsaas-notion-clone","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flostovayne%2Fsaas-notion-clone","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flostovayne%2Fsaas-notion-clone/lists"}