Anima – Pixelgrade LT Universal Theme

Available Themes

Pixelgrade LT themes, based on the Anima universal theme, will follow the [Theme name] + LT naming convention.

Here is the current list of Pixelgrade LT themes:

• Rosa LT ° View demo
• Felt LT ° View demo
• Julia LT ° View demo
• Mies LT ° View demo

Contributing

The essence of open source is that by freely sharing the code, you have the freedom to use it for any purpose, study how it works and adapt it to your needs, improve the program and share your improvements with the community so that we all benefit. 🙏

It's great if you're willing to use your skills, knowledge, and experience to help further refine this project with your own improvements. We really appreciate it and you're 💯 welcome to submit an issue or pull request on any topic.

How can you help?

• 🕵️♀️ Discovered an issue? Please report it here and help us fix it.
• 🛠 Fixed a bug? That’s fantastic! Send a pull request and we will look over it. See CONTRIBUTING.md for the contributing guidelines.
• 🔮 Need a feature? Please take a moment to find out whether your idea fit the wider scope of this theme and provide as much detail and context as possible. Then propose it here.
• 💎 Have you made something great? Share it with us.

Contributors

A manually curated list that include all the valuable people that have contributed to this project with code, user testing, feedback, or mockups. Thank you!

Local Environment Setup Pointers

You need to be careful since we require certain node versions (v14) and PHP versions (v7.4).

For ease of development, it is best to use nvm (https://github.com/nvm-sh/nvm) for node version management and automatic node version switching on shell navigation. For the zsh shell the easiest way is to use oh-my-zsh with the nvm plugin activated.

We use the following oh-my-zsh plugins: plugins=(composer git nvm npm) configured in ~/.zshrc. For automatic node version switching, place this line in ~/.zshrc just below the plugins line: NVM_AUTOLOAD=1. Now whenever you enter a directory through the shell, if it finds a .nvmrc file, it will switch to the specified node version.

Private Local Overlays

This repo supports a split between tracked public templates and ignored local private files.

Tracked files:

• AGENTS.md
• AGENTS.local.example.md
• .claude/napkin.example.md
• .env.example
• bin/bootstrap-private

Ignored files:

• AGENTS.local.md
• .claude/napkin.md
• .env.local
• .private/

Recommended workflow:

1. Put your real private files in a separate private repo, for example anima-private.
2. Store any of these files there when needed:
   • AGENTS.local.md
   • .claude/napkin.md
   • .env.local
3. After cloning anima, configure the private repo once:

git config --local anima.privateRepo git@github.com:<you>/anima-private.git

4. Hydrate the local private files:

bin/bootstrap-private

Useful variants:

# replace existing local private files from the private source
bin/bootstrap-private --force

# symlink the files instead of copying them
bin/bootstrap-private --link

# use an existing local checkout of your private repo
bin/bootstrap-private --source-dir /path/to/anima-private

The bootstrap script syncs AGENTS.local.md, .claude/napkin.md, and .env.local when those files exist in the private source.

License

Anima theme source code is released under the GNU GPL v2 license or later.

2021-2022 © Pixelgrade.