https://github.com/mihaicristianfarcas/adso
Notion-like note-taking app specialized on organizing thoughts and exploring ideas.
https://github.com/mihaicristianfarcas/adso
blocknotejs clerkauth convex-database edgestore full-stack nextjs notebook notes-app notion-clone shadcn-ui typescript
Last synced: 11 months ago
JSON representation
Notion-like note-taking app specialized on organizing thoughts and exploring ideas.
- Host: GitHub
- URL: https://github.com/mihaicristianfarcas/adso
- Owner: mihaicristianfarcas
- License: mit
- Created: 2025-03-22T12:10:39.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-05-28T07:20:07.000Z (about 1 year ago)
- Last Synced: 2025-06-25T17:28:43.082Z (11 months ago)
- Topics: blocknotejs, clerkauth, convex-database, edgestore, full-stack, nextjs, notebook, notes-app, notion-clone, shadcn-ui, typescript
- Language: TypeScript
- Homepage: https://adso-one.vercel.app
- Size: 3.08 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Adso - Modern Note-Taking Application
Adso is a feature-rich, Notion-like note-taking application built with Next.js,
allowing you to create, organize, and share documents with a clean, intuitive
interface.

## Features
- **Rich Text Editor**: Create and edit documents with a powerful block-based
editor
- **Document Organization**: Organize your notes with a sidebar navigation
system
- **Real-time Collaboration**: Changes sync instantly with Convex backend
- **Light/Dark Mode**: Toggle between light and dark themes
- **Cover Images**: Add beautiful cover images to your documents
- **Icon Customization**: Personalize documents with custom icons
- **User Authentication**: Secure login with Clerk authentication
- **File Storage**: Upload and store images with EdgeStore
- **Responsive Design**: Works seamlessly across desktop and mobile devices
## Tech Stack
- **Frontend**: Next.js 15, React 19, TypeScript, Tailwind CSS
- **Backend**: Convex (for real-time database)
- **Authentication**: Clerk
- **Editor**: BlockNote
- **File Storage**: EdgeStore
- **Styling**: Tailwind CSS, Radix UI
## Getting Started
### Prerequisites
- Node.js 18.x or higher
- pnpm, npm, or yarn
### Installation
1. Clone the repository
```bash
git clone https://github.com/yourusername/adso.git
cd adso
```
2. Install dependencies
```bash
pnpm install
```
3. Set up environment variables Create a `.env.local` file in the root directory
with:
```
# Clerk Authentication
NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY=
CLERK_SECRET_KEY=
# Convex
NEXT_PUBLIC_CONVEX_URL=
# EdgeStore
EDGE_STORE_ACCESS_KEY=
EDGE_STORE_SECRET_KEY=
```
4. Start the development server
```bash
pnpm dev
```
5. Open [http://localhost:3000](http://localhost:3000) with your browser to see
the app.
## Usage
- **Create a document**: Click the "+ New Page" button in the sidebar
- **Edit content**: Click on any document to open the editor
- **Add cover image**: Use the cover image tool in the editor toolbar
- **Customize icon**: Click the icon picker to change document icons
- **Publish your work**: Use the "Publish" button to share your work easily via
the provided preview link
- **Toggle theme**: Use the theme toggle in the navbar
## Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
## License
This project is licensed under the MIT License.