Skip to content

chorylee/classroomio

 
 

Repository files navigation

ClassroomIO is a no-code tool that allows you build and scale your own teaching platform with ease.

The Open Source Teaching Platform for Tech Bootcamps
Website | Join Discord community

Codacy Badge

Made with Supabase

✨ About ClassroomIO.com

ClassroomIO Courses page

ClassroomIO.com is a platform for bootcamps, individual educators, and training businesses that brings teaching and learning into one place while at the same time helping them be 10x more productive. With our platform, anyone can run multiple classes and cohorts all from one UI. The application is mobile-first, which means that students can access your lesson materials from any device.

Mission: Provide Students with the Best Learning Experience

At ClassroomIO, our mission is to provide students with the best possible learning experience. We believe in empowering educators with the tools they need to deliver high-quality education that is accessible, engaging, and effective.

Key Features

  1. 📚 Advanced Course Management: You can create unlimited courses, create lessons, invite students, add assignments, grade their assignments, and even generate certificates.
  2. 👨‍👩‍👦 Multi-Teacher Management: You can invite other teachers into your organization and assign them individual courses.
  3. 🤖 AI Integration: We've got OpenAI integration for quick course creation where you can generate course content, lesson outlines, and even generate assignments right from your lesson notes.
  4. 💬 Forum: Students can ask questions in your dedicated community and get answers from either you or other students.
  5. 🏆 Kahoot-Like Quiz: You can create live quizzes to create more engagement in your classrooms.
  6. 💻 Dedicated Student Dashboard: Once you create an account, you get a dedicated dashboard where your students can access all their courses, assignments, and more.
  7. 🔒 Fully open source: You can self-host the entire stack on your servers.

Roadmap Features

  1. Forms: Instead of using Google Forms to collect vital information from your students, you will be able to create forms directly within the dashboard.
  2. Course Announcement: You can send public announcements from the course dashboard to all your students.
  3. Course Templates: You can clone a full course or share templates with other people.
  4. Analytics: You can track data about your students across multiple courses.
  5. Run Courses on Messengers: Students can just join a channel on slack/discord/telegram and a bot automatically sends daily lesson content to your students without you doing anything.

Please reach out to me on twitter if you have any feature request.

Built With

Get a Demo

You can book a quick 15 min demo to see if ClassroomIO is a good fit for you

Book a Call with ClassroomIO.com

Getting Started

To get a local copy up and running, please follow these simple steps.

Prerequisites

Here is what you need to be able to run ClassroomIO.com

Project Structure

This repo is a mono repo that consists of 3 projects:

  1. classroomio-com: The landing page of ClassroomIO hosted here
  2. dashboard: The web application that runs the learning management system.
  3. docs: Official documentation of ClassroomIO hosted here

Development

Gitpod Setup

  1. Click the button below to open this project in Gitpod.

  2. This will open a fully configured workspace in your browser with all the necessary dependencies already installed.

Open in Gitpod

Local Setup

  1. Fork the repo, then clone it using the following command (remember to replace the url with the url from your forked repo)

    git clone https://github.com/rotimi-best/classroomio.git
  2. Go to project folder

    cd classroomio
  3. Set up Node if your Node version does not meet the project's requirements, as instructed by the documentation., "nvm" (Node Version Manager) allows using Node at the version required by the project:

    nvm use

    You first might need to install the specific version and then use it:

    nvm install && nvm use

    You can install nvm from here.

    You also need to have pnpm installed, you can find the installation guide here

  4. Set up your .env file

    • Go to apps/classroomio-com and apps/dashboard
    • Duplicate the .env.example file and rename it to .env
  5. Setup Supabase.

    • Make sure you've downloaded the Supabase cli

    • Install and Start docker

    • Go to the project directory in your terminal and start Supabase

        pnpm supabase start
    • You should get a result like this

        supabase local development setup is running.
      
          API URL: http://127.0.0.1:54321
      GraphQL URL: http://127.0.0.1:54321/graphql/v1
            DB URL: postgresql://postgres:postgres@127.0.0.1:54322/postgres
        Studio URL: http://127.0.0.1:54323
      Inbucket URL: http://127.0.0.1:54324
        JWT secret: super-secret-jwt-token-with-at-least-32-characters-long
          anon key: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJzdXBhYmFzZS1kZW1vIiwicm9sZSI6ImFub24iLCJleHAiOjE5ODM4MTI5OTZ9.CRXP1A7WOeoJeXxjNni43kdQwgnWNReilDMblYTn_I0
      service_role key: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJzdXBhYmFzZS1kZW1vIiwicm9sZSI6InNlcnZpY2Vfcm9sZSIsImV4cCI6MTk4MzgxMjk5Nn0.EGIM96RAZx35lJzdJsyH-qQwv8Hdp7fsn3W0YpN81IU
    • Add Supabase environment variables into app/dashboard folder, which should be taken from the result of pnpm supabase start

        PUBLIC_SUPABASE_URL=<API URL>
        PUBLIC_SUPABASE_ANON_KEY=<anon key>
        PUBLIC_SUPABASE_BUCKET_URL=<Inbucket URL>
    • To view the Supabase studio, open the Studio URL from the result of pnpm supabase start

  6. Install the required dependencies

    pnpm i
  7. Run all projects (in development mode)

    pnpm dev
  8. All projects should start running

  9. Running a specific project

    • classroomio-com: pnpm dev --filter=classroomio-com
    • dashboard: pnpm dev --filter=dashboard
    • docs: pnpm dev --filter=docs

About

Open Source alternative to Google Classroom

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • TypeScript 39.2%
  • CSS 29.0%
  • Svelte 26.6%
  • JavaScript 2.5%
  • PLpgSQL 1.9%
  • MDX 0.4%
  • Other 0.4%