Skip to content

LegendsOfLearning/platform-console

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

50 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

Platform Developer Console πŸš€

Welcome to the Platform Developer Console! We're so excited you're here. This is your one-stop shop for exploring, testing, and integrating with the Legends of Learning Developer Platform. Whether you're building your first educational app or enhancing an existing platform, we've got everything you need to create amazing learning experiences.

What Can You Do Here? ✨

The Platform Developer Console is packed with powerful tools to help you build incredible educational applications. Here's what's waiting for you:

🎯 Build & Manage Assignments

Create standards-aligned assignments that engage students and track their progress. Our interactive assignment builder makes it easy to:

  • Build assignments aligned to specific learning standards
  • Launch assignments directly to students
  • View and manage all your assignments in one place
  • Generate student join links with a single click

πŸ‘₯ User Management Made Simple

Seamlessly create and manage teacher and student accounts:

  • Create teacher and student accounts with OAuth integration
  • Generate secure login links for users
  • View user details and activity
  • Manage user relationships and permissions

πŸ“š Discover Amazing Content

Explore our vast library of educational content:

  • Browse thousands of standards-aligned games, videos, and interactive learning experiences
  • View detailed content information, reviews, and ratings
  • Filter content by subject, grade level, and learning standards
  • Preview content before assigning it to students

πŸŽ“ Navigate Learning Standards

Find the perfect standards for your assignments:

  • Browse comprehensive learning standards aligned to state and national frameworks
  • Search standards by subject area and grade level
  • Understand how content maps to specific standards
  • Build assignments that perfectly match curriculum requirements

πŸ” Powerful Search Capabilities

Find exactly what you need, fast:

  • Search across educational content and standards
  • Use advanced filtering to narrow down results
  • Discover content by keyword, subject, or standard
  • Get instant results with our optimized search engine

πŸ’¬ AI-Powered Assistant

Get help when you need it:

  • Chat with our AI assistant to explore Legends content
  • Get guidance on building assignments
  • Ask questions about API endpoints and integration patterns
  • Receive code examples and best practices

πŸ“Š Real-Time API Activity Monitoring

See what's happening behind the scenes:

  • Monitor all API calls in real-time
  • View request and response details
  • Debug integration issues with ease
  • Track API usage and performance

πŸ“– Interactive Documentation

Learn at your own pace:

  • Explore API endpoints with live examples
  • Access comprehensive API reference documentation
  • View Swagger/OpenAPI specifications
  • Get code samples and integration guides

Getting Started 🎬

Ready to dive in? Let's get you set up!

Prerequisites

Before you begin, make sure you have:

  • Node.js (v18 or later) - Download here
  • npm or pnpm package manager
  • Legends API credentials - You'll need an API key and secret from Legends of Learning

Quick Setup

  1. Clone the repository:

    git clone https://github.com/LegendsOfLearning/platform-console.git
    cd platform-console
  2. Install dependencies:

    npm install
    # or if you prefer pnpm
    pnpm install
  3. Configure your environment:

    Create a .env file in the root directory with your API credentials:

    LEGENDS_API_KEY=your_api_key_here
    LEGENDS_API_SECRET=your_api_secret_here
    LEGENDS_API_URL=https://api.smartlittlecookies.com/api
  4. Start the development server:

    npm run dev
    # or
    pnpm dev
  5. Open your browser:

    Navigate to http://localhost:3000 and you're ready to go! πŸŽ‰

What Makes This Special? 🌟

Built for Developers, by Developers

We've designed every feature with developers in mind. The console provides:

  • Interactive examples you can run right in your browser
  • Real-time feedback on every API call
  • Comprehensive error handling with helpful messages
  • Beautiful, intuitive UI that makes complex tasks simple

Production-Ready Integration Patterns

Learn best practices through real examples:

  • OAuth 2.0 authentication flows
  • RESTful API design patterns
  • Error handling and retry logic
  • Rate limiting and performance optimization

Standards-Aligned Content

Access thousands of educational resources:

  • Games aligned to Common Core, NGSS, and state standards
  • Videos covering K-12 curriculum
  • Interactive learning experiences
  • Content reviewed and rated by educators

Project Structure πŸ“

platform-console/
β”œβ”€β”€ src/
β”‚   β”œβ”€β”€ app/              # Next.js app router pages
β”‚   β”‚   β”œβ”€β”€ assignments/ # Assignment management pages
β”‚   β”‚   β”œβ”€β”€ content/      # Content discovery pages
β”‚   β”‚   β”œβ”€β”€ users/        # User management pages
β”‚   β”‚   β”œβ”€β”€ standards/    # Standards browsing pages
β”‚   β”‚   β”œβ”€β”€ search/       # Search functionality
β”‚   β”‚   β”œβ”€β”€ chat/         # AI assistant chat
β”‚   β”‚   └── docs/         # Documentation pages
β”‚   β”œβ”€β”€ components/       # React components
β”‚   β”œβ”€β”€ lib/              # Utilities and API clients
β”‚   └── contexts/         # React contexts
β”œβ”€β”€ public/               # Static assets
β”œβ”€β”€ docs/                 # Additional documentation
β”‚   └── api-documentation.md
└── package.json          # Project dependencies

Key Features Deep Dive πŸ”

Assignment Builder

The assignment builder is where the magic happens. You can:

  • Select learning standards from our comprehensive database
  • Choose content that matches those standards
  • Assign to specific students or groups
  • Generate launch links instantly
  • Track student progress and completion

API Activity Monitor

Every API call you make is tracked and displayed in real-time. This helps you:

  • Understand how the API works
  • Debug integration issues
  • Learn from example requests
  • Optimize your API usage

Content Discovery

Our content library includes:

  • Educational Games: Engaging, standards-aligned games for K-12
  • Videos: High-quality educational video content
  • Interactive Experiences: Hands-on learning activities
  • Reviews & Ratings: See what educators think about each piece of content

Need Help? 🀝

We're here to help you succeed! Here are some resources:

Contributing πŸ› οΈ

We love contributions! Here's how you can help:

  1. Create a branch:

    • For new features: feat/your-feature-name
    • For bug fixes: fix/your-fix-name
  2. Make your changes:

    • Follow TypeScript best practices
    • Write tests for new features
    • Update documentation as needed
    • Follow the existing code style
  3. Commit your changes:

    feat(platform-console): add amazing new feature
    
  4. Push and create a pull request:

    • Push your branch to GitHub
    • Create a pull request with a clear description
    • We'll review and provide feedback

Development Guidelines

  • TypeScript: We use TypeScript for type safety
  • Testing: Write tests for new features
  • Documentation: Keep docs up to date
  • Code Style: Follow existing patterns and conventions
  • Accessibility: Ensure UI is accessible to all users

What's Next? πŸš€

Once you're comfortable with the console, you can:

  1. Integrate the API into your own application
  2. Build custom workflows using our REST API
  3. Create educational experiences that engage students
  4. Scale your application with our robust infrastructure
  5. Join our developer community and share your creations

License πŸ“„

MIT License

Copyright (c) 2024 Legends of Learning

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.


Happy Building! πŸŽ‰ We can't wait to see what you create with the Legends of Learning Developer Platform. If you have questions, feedback, or just want to say hello, don't hesitate to reach out!

About

Legends of Learning Platform Developer Console

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 2

  •  
  •  

Languages