Giter Site home page Giter Site logo

smartergiving / free-nonprofit-starter-website Goto Github PK

View Code? Open in Web Editor NEW
124.0 7.0 192.0 1.49 MB

A Github Pages template for nonprofits seeking a starter website. Includes online donations and newsletter signup.

HTML 79.41% JavaScript 1.08% Ruby 0.09% SCSS 19.42%
nonprofits jekyll-website online-donations

free-nonprofit-starter-website's Introduction

A Free Website Template for Nonprofits

We want to help introduce the nonprofit community to the powerful world of open source development. Just follow the step-by-step instructions below, and in less than an hour your grassroots nonprofit will have a live, no-cost website complete with online donation capabilities.

But most importantly, by hosting your site and its code on Github you'll allow volunteers to easily contribute to ongoing development of your site.


No Coding Skills Required

If you're the type of person that can set up email on your smartphone, you likely have all the skills needed to take advantage of this template. This isn't that hard...you can do it! ๐Ÿ˜„


Help Others Help You

Github makes it crazy simple for people to help with your site. Whether it's volunteers or paid contractors, you're always just a few clicks away from accepting improvements.


Features

  1. Accept online donations
  2. Capture email addresses to begin building your supporter database

Demo

https://smartergiving.github.io/free-nonprofit-starter-website/

Screenshot

Screenshot


Benefits

  1. Open Source
    Your site and its code will be hosted on Github. This makes it easy for any developer, designer, or copywriter to help customize your site.

  2. Totally Free
    No upfront nor ongoing costs.

  3. Payments by Stripe
    Stripe is used by many tools for nonprofits. When you require a more robust fundraising solution than DonorBox offers, switching is easy.


Getting Started

Note: This project does require rolling up your sleeves a bit. If you're looking for a more user-friendly service (albeit paid), we're big fans of Squarespace and Wix.

Overview


  1. Create Github accounts
  2. Fork the repo
  3. Enter your organization's info in _config.yml
  4. Create DonorBox and Stripe accounts (for online donations)
  5. Create TinyLetter account (for email capture)
  6. Enter DonorBox and TinyLetter credentials in _config.yml
  7. Suggested next steps

Detailed Tutorial


Step 1 Create Github accounts

  1. Get started by clicking the green "SignUp" button at the top of this page

  2. Enter your signup information as instructed and click "Create an account"

  3. On the second page ("Choose your Plan"), check the box that says "Help me set up an organization"
    Screenshot

  4. Follow the remaining steps. Don't forget to confirm your email address.


Step 2 Fork the repo

  1. Click the "Fork" button at the top of this page

  2. When prompted, click the Organization you just set up

  3. Change the name of the repo by clicking "Settings" in the right-hand menu. Name the repo <orgname>.github.io (where <orgname> is the Organization name you chose for Github) and click "Rename". For example, for us here at Smartergiving, we would name the repo smartergiving.github.io.
    Settings

  4. Your site can now be viewed at <orgname>.github.io


Step 3 Enter your organization's info

  1. Click the _config.yml file
    SignUp

  2. Click the edit button
    Edit

  3. Replace the example text with your organization's information
    Enter Information

  4. When finished, "commit" the changes by entering a commit message (e.g. "Update config") in the "Commit changes" box at the bottom of the page. Leave the other options as they are, and click the "Commit changes" button.
    Commit

  5. Preview your site at <orgname>.github.io.

  6. Continue to adjust _config.yml as needed.


Step 4 Create DonorBox account

  1. Go to DonorBox and create an account.

  2. We suggest using the "Organization Sign Up" option, which will walk you through creating a Stripe account. Stripe handles the actual credit card processing.
    DonorBox SignUp

  3. Follow the prompts to add your first campaign.

  4. Important: Be sure you fully understand the risks of accepting online donations.


Step 5 Create TinyLetter account

  1. Go to TinyLetter and create an account by clicking the "Sign Up Free" button

Step 6 Enter DonorBox and TinyLetter credentials

  1. Edit the _config.yml file and enter your credentials in the appropriate spots
  • Find your DonorBox campaign name
    After you've created a campaign, on your dashboard click "edit" for the campaign you'd like to include on your site. 2/3rds of the way down the page you'll see a "Form URL" box. This is where you'll find your Donorbox Username for _config.yml
    DonorBox

  • Find your TinyLetter username
    Your TinyLetter Username can be found on your Profile page.
    TinyLetter


Step 7 Suggested next steps

  1. Ask for help from your supporters or the open source community.
    a. HashtagCharity
    b. Idealist
    c. Reddit (/r/nonprofitprojects)

  2. Continue development on your own
    a. Set up your local machine (follow steps 1 and 2)
    b. Download Github Desktop and Atom (tutorial)

  3. Need Help? Consider attending one of Github's workshops or online trainings


Color Schemes

Select an alternative color scheme by changing the color_scheme: option in _config.yml.

Alternative Colors


Extras

If you know a little HTML/CSS, the project is built on Bootstrap and offers the full suite of Bootstrap components


TODOs

  • CNAME and custom domain instructions
  • Add cleanup items to tutorial
    • Delete gh-pages branch
    • Swap README for a "post-launch" one
  • Open graph metadata
  • Troubleshooting tips

Future

  • Google Analytics
  • Mailchimp
  • Paypal

Credits

Many thanks to Xiaoying Riley of 3rd Wave Media for the wonderful open source template from which this project is based. License: Creative Commons Attribution 3.0 License (CC BY 3.0).

License

The MIT License (MIT)

Copyright (c) 2015 Chad Kruse, SmarterGiving

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

free-nonprofit-starter-website's People

Contributors

chadokruse avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar

free-nonprofit-starter-website's Issues

"theme" variable conflicts with Github-pages new theme offering

Just did a github-pages build with a fork of the theme and got this warning from Github:

You are attempting to use a Jekyll theme, "default", which is not supported by GitHub Pages. Please visit https://pages.github.com/themes/ for a list of supported themes. If you are using the "theme" configuration variable for something other than a Jekyll theme, we recommend you rename this variable throughout your site. For more information, see https://help.github.com/articles/adding-a-jekyll-theme-to-your-github-pages-site/.

I think that when they introduced Jekyll themes recently they reserved the word "theme" in the config file, so it's likely as simple as changing the name of the config variable. I'd be happy to submit a p.r. for this at some point, if that would be helpful. Really appreciate that you've created this.

jekyll 3.9.0 | The <theme> theme could not be found

I am trying to build and test this locally.

However, jekyll serve throws an error, then when I add a standard GH-pages Gemfile bundle exec jekyll serve also throws and error

What should I put in my local Gemfile to get this working locally?

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.