# Newbie: adding a custon theme

**URL:** <https://forum.getkirby.com/t/newbie-adding-a-custon-theme/8661>\
**Category:** Themes\
**Tags:** v2\
**Created:** [October 1, 2017, 12:02am UTC](https://forum.getkirby.com/t/newbie-adding-a-custon-theme/8661 "2017-10-01T00:02:38Z")\
**Posts on this page:** 6\
**Page:** 1

<div class="post-metadata">

**Author:** ![MrT](https://avatars.discourse-cdn.com/v4/letter/m/f08c70/32.png) [@MrT](https://forum.getkirby.com/u/MrT)\
**Post date:** [October 1, 2017, 12:02am UTC](https://forum.getkirby.com/t/newbie-adding-a-custon-theme/8661/1 "2017-10-01T00:02:38Z")

</div>

Hey everybody,

i need help to implement kirby into my custom theme. I tryed several ways, but it didn’t work. To create my theme i worke with the css framework BASE. I’m newbie and need a step by step way form the .html to .php files and the correct folders. I workes with the docs on the kirby page but can’t find my mistakes. I want to include kirby in this theme [http://spotz.de/theme.zip](http://spotz.de/theme.zip) or the resault, but now only made with html → [www.thisisoutdoor.com](http://www.thisisoutdoor.com)

Many thanks

---

<div class="post-metadata">

**Author:** ![texnixe](https://dub1.discourse-cdn.com/flex017/user_avatar/forum.getkirby.com/texnixe/32/5754_2.png) [@texnixe](https://forum.getkirby.com/u/texnixe)\
**Post date:** [October 1, 2017, 6:42am UTC](https://forum.getkirby.com/t/newbie-adding-a-custon-theme/8661/2 "2017-10-01T06:42:04Z")

</div>

Have you read the Getting Started guide?[https://getkirby.com/docs/getting-started](https://getkirby.com/docs/getting-started)

The general procedure and file/ folder structure is explained there in detail.

Don‘t forget to turn on debugging in your config.php file:

```auto
c::set('debug', true);

```

I‘m afraid I don‘t really want to download a zip file, if we need this to answer your questions, maybe you can put it on GitHub?

---

<div class="post-metadata">

**Author:** ![jimbobrjames](https://dub1.discourse-cdn.com/flex017/user_avatar/forum.getkirby.com/jimbobrjames/32/5802_2.png) [@jimbobrjames](https://forum.getkirby.com/u/jimbobrjames)\
**Post date:** [October 1, 2017, 8:57am UTC](https://forum.getkirby.com/t/newbie-adding-a-custon-theme/8661/3 "2017-10-01T08:57:34Z")

</div>

I would suggest using [Plainkit](https://github.com/getkirby/plainkit) as a starting point. As @texnixe suggested, follow the getting started guide because this will explain the fundamentals of how Kirby works.

Basically you need to break down your html into snippets and templates. For instance, your main menu will become snippet that will be used on every template. Same for the footer. Any distinct area can become a snippet, apart from the main bit of text you have and image banner. These will be content for that page.

Additionally, you need a blueprint to match each template that has custom fields defined in it that will allow you to capture the content.

All this is explained well in the getting started guide.

---

<div class="post-metadata">

**Author:** ![texnixe](https://dub1.discourse-cdn.com/flex017/user_avatar/forum.getkirby.com/texnixe/32/5754_2.png) [@texnixe](https://forum.getkirby.com/u/texnixe)\
**Post date:** [October 1, 2017, 10:33am UTC](https://forum.getkirby.com/t/newbie-adding-a-custon-theme/8661/4 "2017-10-01T10:33:38Z")

</div>

> [@jimbobrjames](#):
>
> Additionally, you need a blueprint to match each template that has custom fields defined in it that will allow you to capture the content.

This is only necessary, of course, if you want to use the admin Panel, which is optional.

---

<div class="post-metadata">

**Author:** ![anon77445132](https://avatars.discourse-cdn.com/v4/letter/a/4da419/32.png) [@anon77445132](https://forum.getkirby.com/u/anon77445132)\
**Post date:** [October 1, 2017, 2:30pm UTC](https://forum.getkirby.com/t/newbie-adding-a-custon-theme/8661/5 "2017-10-01T14:30:53Z")

</div>

@MrT:

I fully agree to @texnixe:

> [@texnixe](#):
>
> Have you read the Getting Started guide?[https://getkirby.com/docs/getting-started](https://getkirby.com/docs/getting-started)
> 
> The general procedure and file/ folder structure is explained there in detail.
> 
> Don‘t forget to turn on debugging in your config.php file:
> 
> c::set(‘debug’, true);

But I think, an [updated doc ‘Getting Started’](https://forum.getkirby.com/t/please-update-the-doc-getting-started/7720) can help you more.

---

<div class="post-metadata">

**Author:** ![distantnative](https://dub1.discourse-cdn.com/flex017/user_avatar/forum.getkirby.com/distantnative/32/11319_2.png) [@distantnative](https://forum.getkirby.com/u/distantnative)\
**Post date:** [February 6, 2025, 5:32pm UTC](https://forum.getkirby.com/t/newbie-adding-a-custon-theme/8661/6 "2025-02-06T17:32:00Z")

</div>