Skip to content

sayeedmunees/mdme-frontend

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

15 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

MDME - Mark Down Made Easy ๐Ÿ“

MDME Banner Open Source License Contributions

A modern, open-source markdown editor with AI integration capabilities. MDME (Mark Down Made Easy) provides a clean, intuitive interface for writing and editing markdown with real-time preview functionality.

๐ŸŒ Live Demo

Try MDME โ†’

๐Ÿ“‚ Repositories

๐ŸŽฏ Project Vision

MDME aims to revolutionize the markdown editing experience by combining simplicity with powerful AI-driven features. Our goal is to create an editor that makes markdown accessible to everyone while providing advanced capabilities for power users.

โœจ Current Features

  • Live Preview: See your markdown render in real-time as you type
  • Clean Interface: Distraction-free writing with minimal design focused on your content
  • Responsive Design: Write anywhere on desktop, tablet, or mobile devices seamlessly
  • Document Management: Save, edit, and manage your markdown documents
  • Document History: Track and access your previously saved documents
  • Copy & Export: Easy content management with copy functionality
  • GitHub Flavored Markdown: Full support for enhanced markdown syntax including code blocks, tables, and more

๐Ÿš€ Upcoming AI Features

We're actively working on integrating AI capabilities to enhance your markdown writing experience:

  • AI Writing Assistant: Smart writing suggestions and improvements
  • Content Enhancement: AI-powered grammar and style suggestions
  • Auto-completion: Intelligent markdown syntax completion
  • Content Optimization: SEO and readability improvements
  • Smart Formatting: Automatic formatting suggestions
  • Content Generation: AI-powered content creation assistance

๐Ÿ› ๏ธ Tech Stack

Frontend

  • React with Vite for fast development
  • Modern JavaScript/ES6+
  • CSS3 with responsive design
  • @uiw/react-markdown-editor for enhanced markdown editing experience

Backend

  • Node.js with Express-like architecture
  • JSON Server for RESTful API (current implementation)
  • CORS enabled for cross-origin requests
  • File-based storage with JSON database (db.json)

Current API Endpoints

GET    /markdown     - Retrieve all documents
POST   /markdown     - Create new document
PUT    /markdown/:id - Update existing document
DELETE /markdown/:id - Delete document

๐Ÿ—๏ธ Project Structure

Frontend Structure

mdme-frontend/
โ”œโ”€โ”€ src/
โ”‚   โ”œโ”€โ”€ components/
โ”‚   โ”‚   โ”œโ”€โ”€ Editor/
โ”‚   โ”‚   โ”œโ”€โ”€ Preview/
โ”‚   โ”‚   โ”œโ”€โ”€ Navigation/
โ”‚   โ”‚   โ””โ”€โ”€ History/
โ”‚   โ”œโ”€โ”€ pages/
โ”‚   โ”‚   โ”œโ”€โ”€ Home/
โ”‚   โ”‚   โ”œโ”€โ”€ Editor/
โ”‚   โ”‚   โ””โ”€โ”€ History/
โ”‚   โ”œโ”€โ”€ styles/
โ”‚   โ””โ”€โ”€ utils/
โ”œโ”€โ”€ public/
โ””โ”€โ”€ README.md

Backend Structure

mdme-backend/
โ”œโ”€โ”€ index.js          # Main server file
โ”œโ”€โ”€ db.json           # JSON database
โ”œโ”€โ”€ package.json      # Dependencies
โ””โ”€โ”€ node_modules/     # Installed packages

๐Ÿš€ Getting Started

Prerequisites

  • Node.js (v18+ recommended)
  • npm or yarn
  • Git

Setup Frontend

  1. Clone the frontend repository

    git clone https://github.com/sayeedmunees/mdme-frontend.git
    cd mdme-frontend
  2. Install dependencies

    npm install
    # or
    yarn install
  3. Start the development server

    npm run dev
    # or
    yarn dev
  4. Open your browser

    http://localhost:5173
    

Setup Backend

  1. Clone the backend repository

    git clone https://github.com/sayeedmunees/mdme-backend.git
    cd mdme-backend
  2. Install dependencies

    npm install
  3. Start the backend server

    npm start
  4. Backend will be running on

    http://localhost:3000
    

Full Stack Development

For full stack development, run both frontend and backend servers simultaneously:

# Terminal 1 - Backend
cd mdme-backend
npm start

# Terminal 2 - Frontend  
cd mdme-frontend
npm run dev

๐Ÿค Contributing

We welcome contributions from developers of all skill levels! MDME is completely open source, and we encourage the community to help shape its future.

Ways to Contribute

  • Frontend Development: Improve UI/UX, add new features, enhance editor functionality
  • Backend Development: Improve API design, add database integration, enhance performance
  • AI Integration: Implement intelligent writing features, content suggestions
  • Documentation: Help improve our docs, guides, and tutorials
  • Bug Reports: Report issues and suggest improvements
  • Feature Requests: Propose new functionality
  • Testing: Help test new features and report bugs
  • Design: Contribute to UI/UX improvements

Priority Areas for Contribution

  1. AI Integration: Implement OpenAI/GPT integration for writing assistance
  2. Database Migration: Replace JSON Server with proper database (MongoDB/PostgreSQL)
  3. User Authentication: Add user accounts and document ownership
  4. Real-time Collaboration: Enable collaborative editing features
  5. Enhanced Editor: Add more markdown editing features (tables, math equations)
  6. Export Options: PDF, HTML, and other format exports
  7. Themes: Dark/light mode and custom themes

Getting Started with Contributions

  1. Fork both repositories (frontend and backend)
  2. Create your feature branch
    git checkout -b feature/amazing-feature
  3. Make your changes and commit
    git commit -m 'Add some amazing feature'
  4. Push to the branch
    git push origin feature/amazing-feature
  5. Open a Pull Request on the respective repository

Development Guidelines

  • Follow existing code style and conventions
  • Write clear, descriptive commit messages
  • Add comments for complex logic
  • Test your changes thoroughly
  • Update documentation as needed
  • Ensure both frontend and backend work together seamlessly

๐Ÿ“‹ Roadmap

Phase 1 (Current) - Core Foundation โœ…

  • Basic markdown editor with live preview
  • Document saving and history
  • Responsive design
  • RESTful API with JSON Server
  • CORS enabled backend
  • Theme switching (dark/light)
  • Enhanced export functionality

Phase 2 - AI Integration ๐Ÿšง

  • OpenAI/GPT integration
  • AI writing assistant
  • Smart auto-completion
  • Grammar and style suggestions
  • Content optimization
  • Intelligent formatting

Phase 3 - Enhanced Backend ๐Ÿ“‹

  • Database migration (MongoDB/PostgreSQL)
  • User authentication system
  • Document ownership and sharing
  • Advanced API features
  • Cloud storage integration

Phase 4 - Advanced Features ๐Ÿ”ฎ

  • Real-time collaborative editing
  • Plugin system architecture
  • Advanced export options (PDF, HTML, LaTeX)
  • Version control integration
  • Template system

Phase 5 - Enterprise Features ๐Ÿข

  • Team workspaces
  • Advanced analytics
  • Custom AI models
  • Enterprise security features
  • On-premise deployment options

๐Ÿ› Issues & Support

Found a bug or have a feature request? We'd love to hear from you!

  • Bug Reports: Frontend Issues | Backend Issues
  • Feature Requests: Open an issue in the relevant repository
  • General Discussion: Start a discussion in either repository
  • Questions: Feel free to open an issue with the "question" label

๐Ÿ“Š Current Architecture

โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”       โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
โ”‚                 โ”‚       โ”‚                 โ”‚
โ”‚   React Frontendโ”‚โ—„โ”€โ”€โ”€โ”€โ”€โ–บโ”‚  JSON Server    โ”‚
โ”‚   (Port 5173)   โ”‚       โ”‚  Backend        โ”‚
โ”‚                 โ”‚       โ”‚  (Port 3000)    โ”‚
โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜       โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
                                   โ”‚
                          โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
                          โ”‚                 โ”‚
                          โ”‚   db.json       โ”‚
                          โ”‚   (File DB)     โ”‚
                          โ”‚                 โ”‚
                          โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜

๐Ÿ“„ License

This project is licensed under the MIT License - see the LICENSE file for details.

๐Ÿ‘จโ€๐Ÿ’ป Author

Sayeed Munees

๐Ÿ™ Acknowledgments

  • Thanks to all contributors who help make MDME better
  • Inspired by popular markdown editors and modern development practices
  • Built with love for the open-source community
  • Special thanks to the React and Node.js communities

๐ŸŒŸ Show Your Support

If you find MDME useful, please consider:

  • โญ Starring both repositories (Frontend & Backend)
  • ๐Ÿด Forking and contributing to the project
  • ๐Ÿ“ข Sharing with your network and fellow developers
  • ๐Ÿ’ฌ Providing feedback and feature suggestions
  • ๐Ÿ› Reporting bugs to help us improve

๐Ÿ”— Quick Links


Ready to make markdown easy? Start editing now โ†’

About

A modern, open-source markdown editor with AI integration capabilities. MDME (Mark Down Made Easy) provides a clean, intuitive interface for writing and editing markdown with real-time preview functionality.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors