<img src="/assets/blog/2021-05-skeletor/skeletor_full.png" class="inline-image" style="border: 0;">
<p><a href="https://github.com/ckc-org/skeletor">Skeletor</a> is CKC's foundation for new web projects. It
leverages everything we've learned over our collective decades of experience solving <em>"super fun"</em>
problems.</p>
<p>Continuous deployments, great test coverage, hot reloading for frontend development.. this
base project has it all!</p>

<div style="clear: both">
</div>
<h1>Why is this important?</h1>
<h3>Keeps your house in order from day 1</h3>
<p>It may not seem all that impressive from an outside perspective, but maybe to help illustrate:</p>
<p>Imagine that your entire day is put together and ran <em>perfectly.</em> Tools and best practices are meticulously
put into place to solve the same problems you've encountered dozens of times. When you go to pick out a shirt
in the morning: already laid out for you. On your way to work, but the car won't start? No worries,
there's a battery booster behind the seat. Forgot your office key? Hide-a-key rock ready to go.</p>
<p>All of those little gotchas that set development back, like:</p>
<ol>
<li>New requirements from client/stakeholders, how do we implement these quickly without breaking everything?! (great tests)</li>
<li>Basic features not working right, like password reset or emails</li>
<li>Setting up staging/development environments for the umpteenth time</li>
<li>Get an image of all the schema/models in the database and show how they're connected</li>
<li>If we have to onboard another developer, how do we teach them all this stuff?!</li>
<li>Are all of our licenses open source/free to use?</li>
<li>It's so "annoying" to do Test Driven Development (not with Skeletor setting up everything for you!)</li>
</ol>
<h3>Onboarding new devs</h3>
<p>Skeletor projects benefit from consistent architecture and implementation of development best practices across the board.
Anyone who has a bit of experience with Python or Docker can spin up our repo in seconds. All a new developer
needs to do (assuming they have Docker) is:</p>
<pre><code class="language-bash">$ make
</code></pre>
<p>.. and you're done! This spins up the database, makes a dummy user for testing and any requisite test data
for your project.</p>
<p>With Skeletor, you get consistency, speed, and efficiency when onboarding new folks. Also, as we bring on new
developers, they may have great new pieces of knowledge/experience which get compounded back into Skeletor! It
is always improving.</p>
<h1>What <em>is</em> Skeletor made of?</h1>
<h3>Backend</h3>
<p>Skeletor leverages Django + Python on the backend with a suite of libraries for testing.</p>
<ul>
<li>We use Celery + RabbitMQ (or Redis) for asynchronous tasks like mass emails or resizing large images.</li>
<li>Pytest for testing (xdist, sugar, etc. ooo ya!)</li>
<li>Base classes for functional testing (selenium, cypress, detox)</li>
<li>And more helpers to make Test Driven Development easy to implement, something that saves many headaches for developers and money for clients.</li>
</ul>
<h3>Frontend</h3>
<p>And we use VueJS behind NuxtJS on the frontend.</p>
<ul>
<li>Vuetify for styling and amazing base components</li>
<li>NuxtJS packs things up nicely for you by default</li>
<li>Awesome hot reloading, yay!</li>
</ul>
<div class="img-bordered">
    <img src="/assets/blog/2021-05-skeletor/skeletor_install.png">
</div>
<h1>Why these specific choices?</h1>
<h2>Heroku over AWS or Digital Ocean Apps</h2>
<p>Heroku works well for small-to-medium-sized apps without much need for custom backend setups.</p>
<p>Sometimes we move projects to AWS setups for production or the entire lifecycle. This
depends on the project. However, we've used Heroku to put apps in production and support them
for over 5 years. We love the simplicity!</p>
<p>With Heroku, you have to follow their requirements, like putting files in specific directories or only supporting certain packages.</p>
<p>These requirements are usually done for a good reason, so it's not a huge deal. It becomes a problem when
a client <em>requires</em> an old version of a package or a nonstandard way of running things.</p>
<p><a href="https://ckcollab.com/2019/03/15/heroku-vs-aws.html">Read more about what CKC thinks of Heroku vs AWS!</a></p>
<h2>VueJS over React</h2>
<p>We prefer VueJS over React for the ease of use, integration with old libraries (jQuery),
and the mass amount of support the VueJS project has. It is quite a bit easier to spin
new folks up on Vue, React has many more specific paradigms. Like, you can't just add a
class in React but you can in Vue.</p>
<h1>How to use it?</h1>
<p>You'll clone the repo using <code>django-admin</code> and the <code>startproject</code> command, like so:</p>
<pre><code class="language-bash">$ django-admin.py startproject new_project \
    --template=https://github.com/ckc-org/skeletor/archive/master.zip \
    --name index.md,setup,app.json,README.md
</code></pre>
<p>Then you'll want to edit the README, remove the base project installation instructions, and
run:</p>
<pre><code class="language-bash">$ make
</code></pre>
<p>..that's it! You have a nice base project spun up and ready to start developing on.</p>
<h1>Let us setup a project for you!</h1>
<p>We love crafting beautiful solutions to our client's problems. Send us an email at <a href="mailto:hello@ckcollab.com">hello@ckcollab.com</a></p>

Skeletor: Django + Vue base project