My first game: My Little Shop
About 15 minutes, on your own computer. You need a terminal and some curiosity, not programming experience.
Nothing to install at all? Do the same in the Studio, in your browser: Open the Studio
In about 15 minutes you will have your own clicker shop game, connected to AikaHub: login, nickname, level, achievements. No programming background needed — just a terminal (command line) and some curiosity.
1. Install Node
Download the Node.js LTS version from nodejs.org and install it. Then, in a terminal:
node -v
If you see v18 or higher, you are ready.
2. Download the game
On the Developers page, download the English shop starter (aikahub-shop-en.zip), unzip it and open a terminal in the aikahub-shop folder.
3. Start it and play
npm run dev

Open http://127.0.0.1:5173/ in your browser. Click Log in with AikaHub: for now this is the local Mock Hub, a tiny "pretend AikaHub" on your computer. Pick a test player (e.g. Aika-teszt — that one plays you, the developer).

Press Open the shop!, click the big counter to earn coins, then buy a Lemonade stand: it earns a coin every second by itself. Your first upgrade earns the First Upgrade achievement. You see it in the terminal too (ACHIEVEMENT Aika-teszt …first-upgrade +10 XP) and on the Mock Hub page: http://127.0.0.1:8788/

4. Make it yours
Open the folder in an editor (e.g. VS Code). Everything that changes the game is in src/game.config.js:
- Name:
"name"inaikahub.config.json, plus<title>and<h1 id="title">inindex.html. - Colours:
COLORS(e.g.accent: 0x7af0ff) — the whole page follows them. - Difficulty:
TUNING— more coins at the start (startCoins), cheaper upgrades (priceGrowth: 1.05), a bigger goal (goalCoins: 5000). - Upgrades:
UPGRADES— change apriceor aperSecond, or add a new line (its name goes intosrc/i18n.js).
Save, reload the browser (F5). It is your game now.
A little secret: once in a while (rarely, at most once per visit) a fox customer called Aika drops by, says hello and buys something. Don't want her? src/guest.js tells you how to remove her.
The shop saves itself in the browser: close it, come back, and it carries on. If you changed a number in TUNING or UPGRADES, a fresh shop starts so you see the change at once. Want to start again anyway? Start over (top right).
5. Ask your AI to help
The folder has an AGENTS.md (and a CLAUDE.md): your AI assistant learns the project and its rules from it. Try:
Add a click upgrade: a new upgrade line with a
perClickfield that makes every click on the counter worth more. Follow AGENTS.md, write the comments in English, and runnpm run checkat the end.
6. Connect the real AikaHub
You need an AikaHub account with a verified email address, and you must be 18 or older.
- Open the Developer console: aikahub.com/developers/console, accept the Developer Agreement and the SDK License.
- New client: a
client_idstarting withx-, the game's name, and the redirect URIhttp://127.0.0.1/. - In
aikahub.config.jsonset"clientId"to your id and"hub": "https://aikahub.com". - In the console's Achievements step, Import the
achievementsarray ofaikahub.config.json.
npm run dev, log in again: now the real AikaHub asks whether you let the game in, and your achievements arrive as test unlocks (no XP, only you and your testers see them) until the game is on the Játéktér.
7. Submit it to the Játéktér
Put the game on an https address (the folder without server/, tools/ and mock-hub/), add that address to the redirect URIs, fill in the Playground page in the console and Submit. We review it, and then anyone can play.
Questions? Write to info@aika.hu · Developer guide: aikahub.com/developers