devlopr-jekyll - A Beautiful Jekyll Theme Built for Developers
You can use Devlopr as a starter for building your own Site. we purposely keep the styling minimal and bare to make it easier to add your own flare and markup. (Under Active Development) !
Highly Customizable and No Hosting or Maintainence Cost is required !
devlopr uses Markdown Files to generate data like Blog Posts, Gallery, Shop Products etc. No external database is required.
Launch your Static Site using Devlopr in minutes 🚀
To get started follow this Tutorial
or if you want to try fast :
Follow this steps in browser (takes 5-10 mins):
- Fork this Repo with your name as your_username.github.io
- Visit your Fork repo at https://github.com/your_username/your_username.github.io
- Press "." in keyboard (this will open up vs-code editor in browser) of the repo.
- Customize config.yml file according to your needs (eg. change your Name, Email... etc.)
- Commit your changes, and push
- Wait for CI/CD to build your website. Visit Github Actions to see the build process.
- Once Ready, Your website will be ready at https://your_username.github.io ✨
- Happy Hacking your new site ! For Local changes you can clone locally.
- Enjoy!
Local Development Steps :
To work locally, follow this commands. You might need ruby and git installed.
$ git clone https://github.com/your_github_username/your_github_username.github.io.git
$ cd your_github_username
$ ruby -v
$ gem install jekyll bundler
$ bundler -v
$ bundle update
$ bundle exec jekyll -v
$ bundle exec jekyll serve --livereload
If you are using permission issues, running bundler:
$ sudo rm -rf _site
$ bundle update
$ bundle exec jekyll serve
Start the server locally at http://127.0.0.1:4000/ or http://localhost:4000/
Security
We use codeQL and dependabot alerts for vulnerabality analysis & fixes.
$ bundle audit
Deploy your devlopr-jekyll blog - One Click Deploy
Github Actions
This Project has actions to auto deploy jekyll to github pages and firebase. The deployment target can be set by editing the DEPLOY_STRATEGY
file. Valid values are:
none
: default value. use this if you don't want to deploy the site.gh-pages
: deploys to github pages. This uses a custom action available in the Marketplace - Jekyll Deploy Actionfirebase
: deploys to firebase. Before you can use this you need to first create a firebase project here. You can signup for a Free Spark Plan. Then, in your github repo's settings, go to the secrets section and add the following:FIREBASE_TOKEN
: your firebase token. you can get this by runningfirebase login:ci
with the firebase cli.FIREBASE_PROJECT_ID
: the project id of the project you just created
Demo (Hosted Apps)
- Github Pages Demo - here
- Firebase Demo - here
- Netlify Demo - here
- Vercel Demo - here
- Heroku Demo - here
- AWS Amplify Demo - here
Features :
- Local CMS Admin Support using Jekyll Admin
- Headless CMS Admin Support using Netlify CMS
- Supports Latest Jekyll 4.x and Bundler
- Stylesheet built using Sass
- Comments using Hyvor and Disqus
- SEO-optimized
- Real Time Search - Algolia
- Sell Stuff (Ecommerce) in your Blog using Snipcart
- Send Newsletters using Mailchimp
- Contact Forms Support for Getform, Formspree
- Coding Activity using Wakatime
- Hosting Support for Github Pages, Netlify, Vercel, Heroku, AWS Amplify, Firebase
- CI/CD Support using Travis CI
Jekyll Admin
You can easily manage the site locally using the Jekyll admin : http://localhost:4000/admin
You can check out for all changelogs here
Pull the latest changes
git remote -v
git remote add upstream https://github.com/sujaykundu777/devlopr-jekyll.git
git fetch upstream
git checkout master
git merge upstream/master
git push
Using Docker :
Building the Image :
docker build -t my-devlopr-jekyll-blog .
Running the container :
docker run -d -p 4000:4000 -it --volume="$PWD:/srv/jekyll" --name "my_blog" my-devlopr-jekyll-blog:latest jekyll serve --watch
Using Docker Compose :
Development :
You can run the app in development mode : (your changes will be reflected --watch moded)
Serve the site at http://localhost:4000 :
docker-compose -f docker-compose-dev.yml up --build --remove-orphans
Production :
You can run the app in production mode : (your changes will be reflected --watch moded)
Serve the site at http://localhost:4000 :
docker-compose -f docker-compose-prod.yml up --build --remove-orphans
Stop the app :
docker-compose -f docker-compose-prod.yml down
Once everything is good and ready to go live -
docker-compose -f docker-compose-prod.yml up --build --detach
Contributors:
This project exists thanks to all the people who contribute.
Sujay Kundu 🚇 🎨 💻 |
Ryan Martin 🚇 |
Jack Wu 🐛 |
Iga Kovtun 🎨 🐛 |
Carroll Vance 🐛 |
Andrei Tenescu 🎨 💻 |
Raghwendra Dey 🐛 |
Daniele Santini 🐛 |
Chivaszx 💻 |
resynth1943 🚇 💻 |
Contributions are more than just welcome. Fork this repo and create a new branch, then submit a pull request
-
1.Fork it http://github.com/sujaykundu777/devlopr-jekyll/fork
-
2.Create your feature branch
git checkout -b my-new-feature
-
3.Commit your changes
git commit -am 'Add some feature'
-
4.Push to the branch
git push origin my-new-feature
-
5.Create new Pull Request
Support this Project:
Back this project by Donating to our Open Collective or if you like my workBuymeacoffee.
Thanks to all our Backers ! Become a Backer
For Help :
You can contact me, if you need any help via Email. If you like the project. Don't forget to ⭐ !
Licence
The theme is available as open source under the terms of the MIT License. You can do anything you want, including projects for your clients, as long as you mention an attribution back (credit links in footer). See the Licence file