Building a Simple Journal

19 Aug 2024 | ~4 minute read

I saw a post from Will recently about the CLI journalling tool, jrnl. It looked cool, but had some limitations for my needs, so I decided to build my own.

Will and I had a quick chat about jrnl, and my knee-jerk reaction was to give it a try, but when I took a breath and thought about it, I decided that jrnl wasn't for me.

You see, I'm most likely to write a journal entry before bed, either on my phone, or on my iPad. So a CLI tool is no good to me. This got me thinking about if I were to start journalling again, what my needs would be from a tool. Here's the list I came up with:

I've really enjoyed journalling in the past, but it's always been too much of a headache to maintain. Apps like Day One have too much going on, and I don't like the fact I'm sending my journal to a 3rd party. I tried building a Journal with WordPress in the past, but that was too much faff and so it didn't stick.

The hunt

So with the list above in mind, I started looking for something that would tick most of my requirements. But unfortunately I couldn't find anything.

I've been teaching myself PHP lately, so I figured this could be a fun little project for me to build something that ticks all my boxes. So over the last few days I've been playing around with my text editor, and with a little help from DuckDuckGo and ChatGPT (I got stuck a couple times - like I said, I'm still learning PHP, and Chatty Geeps really helped) I've managed to build something that works for me.

It's 5 PHP files, a tiny bit of JavaScript, and a CSS file (I also import Simple.css). In total, the entire project is around 450KB. So I can dump it onto any web hosting provider that supports PHP, stick a password in front of it, and I'm done.

✅ - COMPLETE

The webUI is ridiculously simple. It's a single text box (that grows as you type - that's the JS) and a list of entries beneath. Here's what it looks like:

A screenshot of my Journal app
Example of the default Journal homepage
An example of the journal homepage with an entry added
With an entry added

✅ - COMPLETE

I've been able to add Markdown support by making use of Parsedown.

An example journal entry being typed in markdown
An example of a journal entry with markdown rendered

✅ - COMPLETE

Under the hood, a journal entry is just a plaintext file that's rendered within the HTML using PHP. Here's the entire journal entry (filename 2024-08-19-152739.txt):

2024-08-19 15:27:39

Today I made this simple little journal. I think it works quite well. It also supports **markdown**. 😉

✅ - COMPLETE

As you can see from the screenshot above, there's an option to delete the journal entry, and I've also added next/previous links for good measure, which should make browsing the journal easier.

✅ - COMPLETE

And with that, that's all my requirement complete. I did consider adding some kind of categorisation mechanism, and I still might. But for now, I think my little journal works really well.

If you're interested in giving it a try, I've dumped a demo online that resets itself every 10 minutes.

Go to the Journal demo

If you wanna give Journal a go yourself, you can nab the code from GitHub.

If you have any suggestions for improving Journal please do let me know - like I said, I'm not a professional developer, and I'm still learning PHP, so there's likely a lot of stuff that can be done better.

Reply by email

← The one before
Ending the PenPals Experiment

Up next →
Windows 11 Is Shite

Want more?

So you've read this post and you're still not satisfied? Ok then, here's some other stuff for you to do: