We are giving away free PCB manufacturing vouchers to the first 20 projects that register. Just follow the steps in the submission preview. Current status: 5/20 left.
Kitnic is a registry of open source hardware electronics projects that are ready to order and build. The most important elements of a Kitnic project page are:
- A prominent link to download the Gerber files and a preview rendering of the board
- The ability to quickly add the required components to a retailer shopping cart (using clever magic in the form of our browser extension)
Help us build a open hardware repository of useful electronics projects!
- Join Riot.im chat or IRC freenode#kitnic
- Post on our Google Groups mailing list
Check out kitnic.it/submit which will guide you through the process.
Currently the kitnic.yaml
makes use of the following fields:
summary: A description for your project
site: A site you would like to link to (include http:// or https://)
color: The solder resist color of the preview rendering. Can be one of:
- green
- red
- blue
- black
- white
- orange
- purple
- yellow
bom: A path to your 1-click-bom in case it isn't `1-click-bom.tsv`.
gerbers: A path to your folder of gerbers in case it isn't `gerbers/`.
Paths should be in UNIX style (i.e. use /
not \
) and relative to the root
of your repository. The YAML format is pretty straight forward but if you need
to know more check the example below and the YAML website. Use this YAML
validator to be extra sure that your kitnic.yaml
is valid.
Check out the repo links of the projects listed on kitnic.it already. The minimum required file tree is something like :
.
├── 1-click-bom.tsv
└── gerbers
├── example.cmp
├── example.drd
├── example.dri
├── example.gko
├── example.gpi
├── example.gto
├── example.plc
├── example.sol
├── example.stc
└── example.sts
A more advanced example could be something like:
.
├── kitnic.yaml
└── manufacture
├── advanced-example-BOM.tsv
└── gerbers-and-drills
├── advanced-example-B_Adhes.gba
├── advanced-example-B_CrtYd.gbr
├── advanced-example-B_Cu.gbl
├── advanced-example-B_Fab.gbr
├── advanced-example-B_Mask.gbs
├── advanced-example-B_Paste.gbp
├── advanced-example-B_SilkS.gbo
├── advanced-example.drl
├── advanced-example-Edge_Cuts.gbr
├── advanced-example-F_Adhes.gta
├── advanced-example-F_CrtYd.gbr
├── advanced-example-F_Cu.gtl
├── advanced-example-F_Fab.gbr
├── advanced-example-F_Mask.gts
├── advanced-example-F_Paste.gtp
└── advanced-example-F_SilkS.gto
with kitnic.yaml
containing:
summary: A more advanced example
site: https://example.com
color: red
bom: manufacture/advanced-example-BOM.tsv
gerbers: manufacture/gerbers-and-drills
- Nodejs >= 6
- fswatch on OSX/Windows or inotify-tools on Linux
- Ninja Build >= 1.5.1
- The rest of the dependencies can be retrieved via
npm install
- Get requirements above and make sure executables are on your path
npm install
(oryarn install
)npm start
(oryarn start
)- Point your browser at
http://127.0.0.1:8080
. The script should watch for file-saves and re-build when you change a source file.