Nicro - a micro blog for neocities!
by hYpercrites
Preview
How it works
I wanted to create something simple. The idea was to simply put text in a .txt-file and boom, there it is.
Okay okay, its a little bit more complex but I swear, it should make sense at the end. Just hear me out!
Okay okay, its a little bit more complex but I swear, it should make sense at the end. Just hear me out!
It has three (four if you count the style too) main components.
- a text-file which contains the text for the blogpost.
- an index-file to tell the script the textfiles name and where to put it (no entry in this file = no post, see it like a draft-system)
- the script which loads the contents of your entries.
How to post
So lets say you want to post something today, so you navigate into the folder "nicro", create a .txt file like 2026-07-13-001.txt and start typing away.Well, kinda. You have to use a little bit of html still.
The content of said text-file should look like this:
<post>
<header>
<date>2026-07-13</date>
</header>
<p>
cool text here.
</p>
</post>
<header>
<date>2026-07-13</date>
</header>
<p>
cool text here.
</p>
</post>
After saving the file, you have to do one more step: you have to put the name of said file (e.g. 2026-07-13-001.txt) in the _index.txt inside the nicro-folder.
It's important to pay attention where to put it. It is top to bottom; what you put on top will show first.
Thats it, you made a blog post!
Installation and configuration
After downloading, extracting and uploading the content of the .zip-file to your neocities site, you have to add the following between your <head>-area:
<link href="css/nicro.css" rel="stylesheet" type="text/css" media="all">
<script src="js/nicro.js" defer></script>
<script src="js/nicro.js" defer></script>
The script picks up the text files mentioned in the _index.txt and shows 3 posts per page. if you want to show more posts, you have to edit line 4 nicro.js inside the js folder:
const POSTS_PER_PAGE = 3;
Last words
You can edit everything as much as you like but please never act like the code is from you. You don't need to credit me on your site but please let the information about me and sources inside of the .css and .js-file. I think thats fair of me not putting any ugly copyright-stuff somewhere visible on your site, no?The color palette i choose to be the default is from here.
The Font the blog is using is called Mononoki Nerd Font and is from here.
And the
source code
is here.- last edited: 2026-07-13