Welcome to Mneme, where learning meets innovation! 📚

Traditional flashcards are so last season! Mneme brings a breath of fresh air to your learning journey. Imagine having the power to create not just flashcards but engaging quizzes in various formats. Whether it's filling in the blanks, matching unordered lists, or even memorizing a line verbatim, Mneme has got your back. But that's not all – each quiz question is backed by reliable sources to ensure accuracy. If something seems off, you can cross-check and correct it right away.

Mneme, named after the Greek Muse for memory, is not just an ordinary learning platform. It's a web application and API designed to revolutionize how you interact with knowledge. You can submit, store, and retrieve a wealth of learning materials in a seamlessly organized database. Dive into articles, news reports, official documents, scientific papers, and more. And don't forget those handy notes that distill complex information into bite-sized chunks. Mneme empowers you with diverse quiz questions and prompts to put your knowledge to the test.

Mneme is an open-source project, and we're calling all passionate learners and developers to join us on this journey. Explore the source code on GitHub, create your own fork, and send pull requests to shape the future of Mneme. Together, we can make learning an exciting adventure!

Need a place to discuss ideas and get involved? Visit our vibrant Discord server.

Ready to dive in? Setting up Mneme from the Git repository is a breeze:

1. Clone the Repository:

   git clone https://github.com/mneme-app/app.git

2. Install Dependencies:

   npm install

3. Configure Your Environment: Open the mneme/sample.env file and follow the instructions to create your personalized .env file. Don't forget to include the URL to your MongoDB database.

4. Fire Up the Development Server:

   npm run dev

   Now, point your browser to http://localhost:3000 and experience Mneme in action!

Mneme takes care of both aesthetics and performance. We use next/font to optimize and load the sleek Inter font, providing a delightful reading experience.

Mneme is a unified platform that serves both the website and the API. Currently, we offer multiple API endpoints and HTTP verbs for updating the database through the API. To set up your personal system, you'll need the URI of a MongoDB database. You can either run a local instance or follow our instructions in the "sample.env" file to configure the URI.

Our journey ahead involves creating three essential API endpoints, each corresponding to distinct Mongoose models. Here's a glimpse of where Mneme is headed:

• Source Model: We're introducing a dedicated model for linking reliable sources of subject-related information for study.
• Note Model: Expect a model that supports concise summaries or explanations drawn from multiple sources, enhancing note reliability.
• Quiz Model: Dive into versatile question formats, including prompt/response, fill-in-the-blank, ordered or unordered lists, and more. We're even exploring multimedia prompts with WCAG-compliant text alternatives.

Join us on this thrilling journey to reshape learning and knowledge sharing with Mneme!

Are you ready to be part of something big? We're thrilled to have developers like you join our mission. Here's how to get started:

1. Fork the Repository: Click the "Fork" button at the top right corner of the Mneme repository on GitHub. This creates a copy of the repository under your GitHub account.

2. Clone Your Fork: Clone your forked repository to your local machine using:

   git clone https://github.com/YourUsername/mnemefeast.git
   # Add the link to your forked repository

3. Create a New Branch: Create a new branch for your changes with a descriptive name:

   git checkout -b feature/your-feature-name

4. Make Changes: Make the desired improvements and enhancements.

5. Commit Changes: Commit your changes with a clear and concise message:

   git commit -m "Add your descriptive commit message here"

6. Push Changes: Push your changes to your forked repository on GitHub:

   git push origin feature/your-feature-name

7. Create a Pull Request: Visit the original Mneme repository on GitHub and click the "New Pull Request" button. Compare your branch with the main branch of the Mneme repository and provide a detailed description of your changes.

8. Review and Merge: After your pull request is reviewed and approved, it will be merged into the main Mneme repository.