npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

tscircuit

v0.0.345

Published

<div style="display: flex; flex-direction: column;"> <div>Make electronics using Typescript, React, and <a href="https://text-to-footprint.tscircuit.com" target="_blank">AI</a>. We recommend starting with our <a target="_blank" href="https://tscir

Downloads

869

Readme

⏣ tscircuit - React for Circuits

Meet Founder of TSCircuit - Seve! 👋⚡

https://github.com/tscircuit/tscircuit/assets/1910070/63610730-41e6-4a00-9748-e4c3691e5ca9

Table of Contents 🧾

  1. About tscircuit
  2. Examples
  3. Getting Started
  4. Features
  5. FAQs
  6. Development Sub-Projects / Organization
  7. Other Links

About tscircuit

tscircuit is a library complemented by a registry, package manager, command line tool and AI electronic design suite that makes it easy to create, share, export and manufacture electronic circuits. It uses React Fiber to render circuits into web pages.

Think of tscircuit as "React for Electronics" It allows you to design real-world electronic circuits using Typescript and React. This is what tscircuit code looks like, instead of creating web element like “div”, you create circuit elements like “chip”, “resistor” or “capacitor”, then instead of rendering a website, we render a 3d circuit (that you can actually order!) 🚀

Using tscircuit, you can design things like a fully functional keyboard! Once you've completed your design, you can export it to a manufacturer and order a real, functional circuit board!

Example Circuits

const Circuit = () => (
  <board width="50mm" height="50mm" center_x={0} center_y={0}>
    <MySubcomponent name="U1" center={[0, 0]} footprint="sot236" />
    <resistor
      x={2}
      y={-0.5}
      name="R1"
      resistance="10ohm"
      footprint="0805"
      pcb_x="4mm"
      pcb_y="-1mm"
    />
    <ground x={3} y={1} name="GND" />
    <trace path={[".U1 > .D0", ".R1 > .left"]} />
    <trace path={[".R1 > .right", ".GND > .gnd"]} />
  </board>
)

Example Circuit Rendering

Getting Started

You can do everything you need to do with tscircuit using the tsci command line tool.

npm install -g tscircuit

tsci dev

Open your browser to http://localhost:3020!

tsci Server Preview

More Features!

  • [x] Preview PCBs & Schematics in your browser
  • [x] Use normal Typescript/React tooling
  • [x] Export Gerbers, Pick'n'Place and BOM for manufacturing
  • [x] Add registry packages with tsci add
  • [x] Publish subpackages to the registry with tsci publish
  • [x] Simplified, extensible auto-routing for schematics and PCBs
  • [x] Generate footprints from text using AI

FAQ

Is tscircuit free?

tscircuit is completely free and MIT-licensed open-source

How does this work?

tscircuit uses the same thing that React Native and react-three-fiber use to render to mobile or 3d to render PCBs and schematics (it's called React Fiber!)

You can render schematics or PCBs in any React project like this:

import { Schematic } from "@tscircuit/schematic-viewer"

export const MyApp = () => (
  <div>Regular web react here!</div>
  <Schematic>
   <resistor name="R1" resistance="10k" />
  </Schematic>
)

tscircuit has a bunch of extra tools and exports in the command line, so it's a bit easier to use tsci dev to develop circuits (you can always publish and import them later)

Is this ready for production?

No! Although I've ordered a fully assembled circuit (source code), this project is still very very early!

How does the registry work?

The tscircuit registry fully implements the npm registry. When you run tsci init a .npmrc file is created in your project so that any npm add or npm install for a package starting with @tsci/* will go to the tscircuit registry instead of the npm registry.

# Example .npmrc
# This line says "any package from the org @tsci should use the tscircuit registry server
@tsci:registry=https://registry-api.tscircuit.com/npm

Can I use a different registry?

Yes! You can use the same trick and modify the .npmrc file for your project. You can run your own npm registry with verdaccio

Can I test this in my browser?

Yes! There is a playground tool!

Do I have to specify the position of every component?

I'm working on autolayout functionality where you will hopefully only need to tweak things like the spacing. The goal of anything auto

Is the auto-routing good?

The auto-routing is very basic. You can adjust the paths by adding pcb_route_hints to a <trace />. Over time, we'll get good, fast auto-routing algorithms and also ways to "bake & cache" a route over a longer time period.

Can I export into other tools for routing?

This isn't currently possible but a major current objective. If you're interested in writing a module that can convert tscircuit soup JSON into another editor's format, reach out on our campfire!!

I found a bug or have an idea for a feature, what should I do?

Please create an issue!

How can I follow along?

Does this use AI?

No, but AI is pretty good at generating circuits! Try it with copilot!

What big features are coming?

  • [ ] Type-safe traces
  • [ ] Autolayout and autorouter improvements
  • [ ] Layout and route "baking" for more complex routes/layouts
  • [ ] Lots and lots of static analysis
  • [ ] SPICE output!
  • [ ] Export to other EDA tools
  • [ ] Less bugs! A lot less bugs!

Development Sub-Projects / Organization

tscircuit includes a lot of different independently-runnable sub-projects. Here's a quick guide to navigating all of the sub-projects:

Core Libraries

| Project | Description | | ---------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------- | | tscircuit | The main package, packages up everything into a single version | | @tscircuit/builder | A typescript-native library for building circuits (no React). Converts typescript into "the soup format" | | @tscircuit/cli | The tscircuit command line tool tsci and development environment | | @tscircuit/snippets | The main website, playground and online development environment for tscircuit | | @tscircuit/schematic-viewer | The Schematic renderer | | @tscircuit/pcb-viewer | The PCB renderer | | @tscircuit/react-fiber | Bindings from builder to React, React types | | @tscircuit/routing | Routing algorithms for schematic and PCB traces | | @tscircuit/autolayout | Layout algorithms for schematics | | @tscircuit/footprinter | DSL for creating footprints | | kicad-mod-converter | Convert kicad_mod files to and from JSON | | @tscircuit/kicad-viewer | View the KiCad official footprints online |

Other Links

  • tscircuit.com - The official tscircuit website, registry and playground
  • discord - Join the community server where all the primary conversations happen
  • @seveibar - Twitter for author of tscircuit with dev sessions and upcoming features