Bring art you already made
If you made every piece somewhere else (by hand, in another tool, one image at a time) you do not need layers. Give KURV the finished art and the list that says what each piece is, and everything after that is the same as any other collection: rarity, publish, launch, mint.
Start at Launch and choose the collection type: Generative layers + uniques; Finished images and GIFs; Audio NFTs; Short videos; Code art; 3D models. Continue through Name → How many → Description, then upload the files for that type. On the name step, Back returns to the type chooser; Change collection type also returns there from later preparation steps. Your name, size and description are kept. Only the layers option asks for trait layers; the other types use finished art.
| Files | Formats | Maximum |
|---|---|---|
art/ | PNG, GIF, WebP, JPG | 20 MB |
Audio NFTs: media/ | MP3, WAV, FLAC, OGG, M4A | 50 MB |
Short videos: media/ | MP4, WebM | 200 MB |
3D models: media/ | GLB | 50 MB |
Code art: code/ | HTML | 5 MB |
The folder
Section titled “The folder”blobs/ metadata.json art/ 1.png 2.png 3.pngTwo things, side by side: a folder called art holding your pieces, and a file called metadata.json beside it listing them in order.
- Number the pieces
1,2,3… up to however many you have. Start at 1 and skip nothing. - The number is the piece’s id. Piece
7.pngis the seventh entry inmetadata.json, and it mints as#7. - Every piece is the same kind of file. A folder of PNGs, or a folder of GIFs, not a mix.
What a piece can be
Section titled “What a piece can be”| Type | Extension | Notes |
|---|---|---|
| PNG | .png | Transparency is kept. |
| GIF | .gif | Animated GIFs stay animated. |
| WebP | .webp | Still or animated. |
| JPG | .jpg, .jpeg | No transparency. |
One piece can be up to 20 MB. That is the same limit the publisher enforces, so a folder KURV accepts is a folder KURV can publish.
Your file is the file that gets published. KURV never re-draws, re-sizes or re-encodes a piece, which is why an animated GIF is still animated on your mint page, on the shelf and in every wallet that shows it. The only thing built from your art is a short looping preview of the whole collection, and that is a separate file: your pieces are untouched.
metadata.json
Section titled “metadata.json”A list, in square brackets. One entry per piece, in the same order as the numbers on the files.
[ { "name": "Blob #1", "description": "The first one.", "attributes": [ { "trait_type": "Body", "value": "Gold" }, { "trait_type": "Eyes", "value": "Laser" } ] }, { "name": "Blob #2", "attributes": [ { "trait_type": "Body", "value": "Blue" }, { "trait_type": "Eyes", "value": "Laser" } ] }]name: required. What collectors see on the piece. KURV does not rename it.description: optional. Per piece. The collection’s own description is asked once on the screen where you pick the folder.attributes: required, and a list. A piece with no traits gets"attributes": [].- Each attribute is a
trait_typeand avalue. The value can be a word or a number. display_typeandmax_valueare carried through if you use them.
This is the OpenSea attribute shape, so a file exported from most tools already fits.
animation_url is kept too, when it is an ipfs:// link (see Songs and videos below). Anything else in an entry is left out. The image field is written by KURV when the collection is published, because only then does the art have an address.
Traits a piece does not have
Section titled “Traits a piece does not have”Leave the attribute out. A piece with no Hat simply has no Hat entry, and KURV reads that as “this one has no hat”: it counts it, and it works out how rare going without is.
Songs and videos
Section titled “Songs and videos”A piece can be a song or a video. Its picture stays the cover, and its file sits beside it with the same number:
my-album/ metadata.json art/ 1.png 2.png media/ 1.mp3 2.mp3- Sound: MP3, WAV, FLAC, OGG or M4A, up to 50 MB.
- Video: MP4 or WEBM, up to 200 MB.
- Every file needs a cover. A piece can go without a file.
- KURV reads each file’s first bytes, so a renamed file is refused.
- A piece in
metadata.jsoncan instead name a file you stored yourself:"animation_url": "ipfs://…". A link to any other server is refused, because KURV could not keep it playing.
Nothing plays until someone presses play, and only one plays at a time. To sell a collection sealed, turn on Hide until the reveal when you publish: pictures, songs and videos stay in private storage until the reveal makes them public, and only the holder of a piece can see it first, if you chose that. Wallets and marketplaces may show only the cover.
Before you publish, you tick a box saying you made these files or have the right to sell them. Some AI music plans do not allow resale, so check your plan first. Anyone can report a file, and KURV can take a file down.
3D models and code art
Section titled “3D models and code art”A piece can also be a 3D model, and a whole collection can be code art. Both keep a picture as the cover, so a wallet that shows only pictures still shows each piece.
A 3D model is one binary glTF file (.glb) per piece, up to 50 MB, in the media folder beside the songs and videos, numbered like its cover:
my-sculptures/ metadata.json art/ 1.png media/ 1.glb50 MB is what a phone can open: a wallet or a marketplace loads the whole file before it draws anything, and most game-ready and scanned models are 5 to 30 MB. A .gltf file with its textures beside it is not taken: export one .glb. KURV reads each file’s first bytes, so a renamed file is refused. On KURV the piece opens in a 3D view when someone presses View in 3D.
Code art is one page for the whole collection, in a code folder, up to 5 MB:
my-sketches/ metadata.json art/ 1.png 2.png code/ sketch.js p5.min.js- A p5.js sketch:
sketch.js, withp5.min.jsfrom p5js.org beside it, and any other library as a.jsfile. KURV writes them into one page. - Or your own page: one
index.htmlwith every script written inside it. - Every piece gets its own number and hash, so each one draws differently, and the same every time. Your code reads them as
kurv.id,kurv.hashandkurv.random().Math.random()follows the same seed, so p5’srandom()andnoise()need no change. - Each piece still needs its cover in
art. Make it from your sketch with the same hash. - The page reaches nothing outside itself: no internet, no other files, no
eval, no WebAssembly. A page that names an outside address is refused when you pick the folder, and anything it tries when it runs is blocked.
How KURV keeps you and collectors safe. A model or a piece of code art is never drawn on KURV’s own site. It opens only after a press, in a sealed frame on a separate address, with no cookies, no access to your wallet or to KURV, no internet, no popups and no way to leave its frame. A piece that stops answering, tries to leave, or runs for three minutes is closed. The address of that frame is not KURV’s, so if a piece ever showed something that looks like a wallet prompt, it could not be one.
A sealed sale (Hide until the reveal) cannot carry a model or code art. Before you publish, you confirm you made the model or the code yourself, or hold a license to sell it. Anyone can report a piece, and KURV can take it down. On OpenSea the same files work: animation_url holds the model (model/gltf-binary) or the page (text/html), and on Solana the piece’s category is vr or html.
Rarity
Section titled “Rarity”KURV reads the trait_type and value of every piece and scores the collection the same way it scores one it generated: a piece’s score is the sum of 1 / how common each of its traits is, and rank 1 is the rarest. You do not set anything. Ties share a rank, the way a results table does.
The preview grid shows each piece with its rank, so you can check the scoring against what you expected before you publish.
Picking the folder
Section titled “Picking the folder”- On a computer: press the button and choose the folder, or drag the folder anywhere onto the page.
- On a phone: there is no folder to pick, so zip the folder and press Pick a ZIP.
Your pieces are opened in your own browser. Nothing leaves your machine until you press Publish.
If something is off
Section titled “If something is off”KURV checks the whole folder before it shows you anything, and it names the piece:
metadata.json describes 500 pieces and the art folder holds 499.Piece 312 has no art: nothing in the art folder is named 312.Piece 44 in metadata.json has no name.The art folder mixes .png and .gif files.Piece 8 is 22 MB, over the 20 MB one piece can be.
Fix it in your file manager and pick the folder again. Nothing you typed on the screen is lost.
What happens next
Section titled “What happens next”- Preview. Every piece, as it is, with its rank.
- Publish. Your files go to IPFS, pinned by KURV. Freeze makes the link to them permanent. Publishing is free.
- Launch. The wizard asks for the ticker, the price, the coin it is bought in and the royalty, and you sign the collection onto Base. Every collection launched on KURV has a Vault, unless its creator chooses none at launch. You decide how much of each mint goes into it, from nothing at all.
From Publish onwards it is the same flow as a collection built from layers: see Publish your files and Launch your collection.
Nothing here is financial advice. Read Risks and disclaimer before you mint, buy or sell back. Back to kurv.fun. Privacy policy. Terms of use. .