Best way of starting a new Hologram project?

Hi,

What’s the best way of starting a Hologram project, from scratch, and is there a simple folder structure we can follow?

Thanks

2 Likes

The structure should be considered similar to Phoenix - in short you have full flexibility.

Here is an installation guide:

1 Like

Hi @Richardm! Welcome to the forum! :slight_smile:

Currently, Hologram runs on top of Phoenix, so the best approach is to:

  1. Use mix phx.new (docs here) to create your Phoenix project
  2. Install Hologram on top of it following the Installation Guide that @Eiji mentioned
  3. Follow Phoenix conventions generally (though you can use the app directory as described in the installation guide)

For experimenting and getting a feel for things, you can also clone the Hologram skeleton app to play around with.

In August, Hologram will have a standalone mode! This version will use some Phoenix primitives under the hood (like PubSub) but hide all that complexity from you. The goal is to give you exactly the experience you see in our docs without needing to know Phoenix at all. This standalone version will be obsessing over developer experience and will be maximally simple and streamlined with its own Hologram conventions.

Hope this helps! Let me know if you have any other questions.

10 Likes

:raising_hands:t3: let’s go!

2 Likes

Thank you. I’ve already created a phoenix project, so I’ll see if I can add hologram in.

What does standalone mean?

Richard

In this context, “standalone mode” means Hologram will be a complete, self-contained framework with its own development experience. You’ll get something like mix holo.new my_app and work entirely with Hologram’s conventions and tools - no Phoenix knowledge required.

7 Likes