Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
110 changes: 48 additions & 62 deletions docs/chapter1/1introduction.md
Original file line number Diff line number Diff line change
@@ -1,67 +1,53 @@
---
id: chapter1-introduction
title: "Introduction"
description: "Introduction page in Chapter1 of CircuitVerse documentation."
slug : /
description: "Introduction to CircuitVerse and its features."
slug: /
---

# Introduction

<iframe
width="100%"
height="330px"
src="https://circuitverse.org/simulator/embed/701"
id="projectPreview"
scrolling="no"
webkitAllowFullScreen
mozAllowFullScreen
allowFullScreen
>
{" "}
</iframe>

Inspired by Logisim, CircuitVerse is an open-source educational tool for designing and visualizing digital logic circuit simulations in the cloud. Users including educators, students, electronic engineers, and hobbyists can play with digital circuit simulations from their browsers for exploring different “what-if” scenarios. As required, a user can share their creations using unique circuit URLs, or fork different contributions of the CircuitVerse community to yield their curiosity. Figure 1 shares a screenshot of a ripple carry adder simulation built using CircuitVerse.

![](/img/img_chapter1/1.1.png)

<div align="center">
<em>Figure 1.1: Ripple Carry Adder simulation built using CircuitVerse</em>
</div>

Developed for educators by educators, the CircuitVerse platform delivers high class learning experience in a scalable way. Educators can manage, track, and achieve their classroom learning goals in a single, powerful solution. They can create and manage different student groups, post different assignments, define submission deadlines and add or export grades (refer Figure 2). Using the CircuitVerse Chrome extension, educators can embed live circuits in their Google Slides and demonstrate concepts without navigating across different tabs. Alternatively, they can also export images or embed iFrames within their webpages.

![](/img/img_chapter1/1.2.png)

<div align="center">
<em>
Figure 1.2: Educators can manage, track, and achieve their classroom
learning goals using CircuitVerse platform
</em>
</div>

As the CircuitVerse community grows, educators and students can join the online forums to share ideas, questions, and resources related to teaching and learning digital logic design using CircuitVerse.

![](/img/img_chapter1/1.3.png)

<div align="center">
<em>
Figure 1.3: Connect and collaborate on CircuitVerse Forum for sharing ideas,
questions, and resources related to teaching and learning digital logic
design
</em>
</div>

Watch the below video for a quick demonstration of the CircuitVerse platform.

<div>
<iframe
width="500px"
height="400px"
src="https://www.youtube.com/embed/3Df-2Cn_80A"
frameborder="0"
scrolling="no"
webkitAllowFullScreen
mozAllowFullScreen
allowFullScreen
></iframe>
</div>
## What is CircuitVerse?

Inspired by Logisim, **CircuitVerse** is an open-source educational platform for designing and visualizing digital logic circuits directly in the browser. It enables educators, students, electronics engineers, and hobbyists to experiment with digital circuit simulations and explore various "what-if" scenarios.

Users can share their creations using unique circuit URLs or fork projects from the CircuitVerse community to satisfy their curiosity.

<figure>
<img src="/img/img_chapter1/1.1.png" alt="Ripple Carry Adder simulation built using CircuitVerse" />
<figcaption>Figure 1.1: Ripple Carry Adder simulation built using CircuitVerse</figcaption>
</figure>

---

## Classroom Management

Developed for educators by educators, CircuitVerse delivers a **high-quality learning experience** at scale. Educators can:

- Create and manage student groups
- Assign projects with deadlines
- Track submissions and export grades

Using the CircuitVerse Chrome extension, instructors can embed live circuits into Google Slides or export simulations as images or iFrames.

<figure>
<img src="/img/img_chapter1/1.2.png" alt="Classroom management interface in CircuitVerse" />
<figcaption>Figure 1.2: Classroom management features in CircuitVerse</figcaption>
</figure>

---

## Community & Collaboration

As the CircuitVerse community grows, educators and students can connect through online forums to share ideas, ask questions, and collaborate on digital logic design concepts.

<figure>
<img src="/img/img_chapter1/1.3.png" alt="CircuitVerse community forum interface" />
<figcaption>Figure 1.3: CircuitVerse community forum</figcaption>
</figure>

---

## Video Overview

Watch the video below for a quick demonstration of the CircuitVerse platform:

<iframe width="100%" height="400" src="https://www.youtube.com/embed/3Df-2Cn_80A" title="CircuitVerse Platform Overview" loading="lazy" allowfullscreen></iframe>
57 changes: 57 additions & 0 deletions docs/chapter1/1introduction.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,57 @@
---
id: chapter1-introduction
title: "Introduction"
description: "Introduction to CircuitVerse and its features."
slug: /
---
Comment on lines +1 to +6
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🔴 Critical

🧩 Analysis chain

🏁 Script executed:

# Search for both files in the docs directory
fd -name "1introduction\.*" -type f

# Check front matter in both files
fd -name "1introduction\.md" -o -name "1introduction\.mdx" | xargs -I {} sh -c 'echo "=== {} ===" && head -20 {}'

# Also search for all instances of chapter1-introduction id in the codebase
rg "id: chapter1-introduction" -t md -t mdx

Repository: CircuitVerse/CircuitVerseDocs

Length of output: 562


🏁 Script executed:

# Search for both files
fd "1introduction\.(md|mdx)$" docs/

# Search for the id across markdown files with correct syntax
rg "id: chapter1-introduction" --type markdown docs/

# Also search in mdx files by content
fd "1introduction\.mdx$" docs/ | xargs cat | head -20

# And check the md file
fd "1introduction\.md$" docs/ | xargs cat | head -20

Repository: CircuitVerse/CircuitVerseDocs

Length of output: 1921


Duplicate id and slug conflict with 1introduction.md.

Both docs/chapter1/1introduction.md and docs/chapter1/1introduction.mdx declare id: chapter1-introduction and slug: /. Docusaurus will fail or behave unpredictably when two files in the same docs plugin instance share the same document ID or route. Remove or rename one of these files.

🤖 Prompt for AI Agents
In `@docs/chapter1/1introduction.mdx` around lines 1 - 6, Two docs files share the
same frontmatter id ("chapter1-introduction") and slug ("/"), causing a
Docusaurus route/ID collision; fix by editing one of the files and giving it a
unique frontmatter id and/or slug (change the id value and/or slug value in the
frontmatter for either the MDX or MD file) and then update any internal links or
references that point to the old id/slug so routing and cross-links continue to
work.


## What is CircuitVerse?

Inspired by Logisim, **CircuitVerse** is an open-source educational platform for designing and visualizing digital logic circuits directly in the browser. It enables educators, students, electronics engineers, and hobbyists to experiment with digital circuit simulations and explore various "what-if" scenarios.

Users can share their creations using unique circuit URLs or fork projects from the CircuitVerse community to satisfy their curiosity.

![Ripple Carry Adder simulation built using CircuitVerse](/img/img_chapter1/1.1.png)

*Figure 1.1: Ripple Carry Adder simulation built using CircuitVerse*

<hr />

## Classroom Management

Developed for educators by educators, CircuitVerse delivers a **high-quality learning experience** at scale. Educators can:

- Create and manage student groups
- Assign projects with deadlines
- Track submissions and export grades

Using the CircuitVerse Chrome extension, instructors can embed live circuits into Google Slides or export simulations as images or iFrames.

![Classroom management interface in CircuitVerse](/img/img_chapter1/1.2.png)

*Figure 1.2: Classroom management features in CircuitVerse*

<hr />

## Community & Collaboration

As the CircuitVerse community grows, educators and students can connect through online forums to share ideas, ask questions, and collaborate on digital logic design concepts.

![CircuitVerse community forum interface](/img/img_chapter1/1.3.png)

*Figure 1.3: CircuitVerse community forum*

<hr />

## Video Overview

Watch the video below for a quick demonstration of the CircuitVerse platform:

<iframe
width="100%"
height="400"
src="https://www.youtube.com/embed/3Df-2Cn_80A"
title="CircuitVerse Platform Overview"
loading="lazy"
allowFullScreen
/>
Loading