Skip to content

ChurchApps/B1Admin

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

1,363 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

B1Admin

B1Admin is completely free, open-source church management software that allows you to manage key data on church members and visitors. It offers comprehensive features including member and guest information tracking, attendance management with a self check-in app, group coordination, donation tracking with detailed reports, and custom form creation. Visit https://b1.church/ to learn more.

Get Involved

๐Ÿค Help Support Us

The only reason this program is free is because of the generous support from users. If you want to support us to keep this free, please head over to ChurchApps or sponsor us on GitHub. Thank you so much!

๐Ÿ˜๏ธ Join the Community

We have a great community for end-users on Facebook. It's a good way to ask questions, get tips and follow new updates. Come join us!

โš ๏ธ Report an Issue

If you discover an issue or have a feature request, simply submit it to our issues log. Don't be shy, that's how the program gets better.

๐Ÿ’ฌ Join us on Slack

If you would like to contribute in any way, head over to our Slack Channel and introduce yourself. We'd love to hear from you.

๐Ÿ—๏ธ Start Coding

If you'd like to set up the project locally, see our development guide. The short version is:

  1. Copy dotenv.sample.txt to .env and updated it to point to the appropriate API urls.
  2. Install the dependencies with: npm install
  3. Run npm run postinstall to get language files
  4. run npm start to launch the project.

โš™๏ธ Payment Gateway Setup

To accept online donations you must first register for developer credentials with one of the supported payment providers:

  • Stripe: Visit https://dashboard.stripe.com/register (or sign in at https://dashboard.stripe.com/login), then navigate to Developers โ†’ API keys to copy your Publishable Key and Secret Key for both test and live modes.
  • PayPal: Go to https://developer.paypal.com/, log in or create an account, then under My Apps & Credentials create a new application to obtain your Sandbox and Live Client ID and Secret.
  • KingdomFunding: Kingdom Funding is a payment processing option built with Christian values in mind! To get started:
    1. Visit the Kingdom Funding signup page (https://kingdomfunding.org/begin-registration/?sponsor=b1) and fill out the application form.
    2. Kingdom Funding will walk you through the account onboarding process, including identity verification and bank account setup.
    3. Once your account is approved, you will receive your API Source Key (private key) and Tokenization Key (public key) from the merchant portal.
    4. In B1Admin, go to Settings โ†’ Giving Settings, select Kingdom Funding as the provider, paste in your Public Key (Tokenization Key) and Private Key (API Source Key), and save.
    5. Configure the webhook URL in your Accept Blue Control Panel so the system gets notified about transaction state changes (recurring charges, ACH settlements, returns):
      • URL: https://api.churchapps.org/giving/donate/webhook/kingdomfunding?churchId={YOUR_CHURCH_ID} (replace {YOUR_CHURCH_ID} with the church ID from B1Admin โ€” the exact URL is also shown with a copy button in Giving Settings when Kingdom Funding is selected)
      • Generate a Webhook Signing Secret in the Accept Blue Control Panel and paste the same value into the Webhook Key field in B1Admin's Giving Settings. Both sides must match โ€” webhooks are rejected if the key is missing or wrong.
      • Subscribe at minimum to: transaction.succeeded.charge, transaction.declined.charge, transaction.status.settled, transaction.status.returned.

After obtaining your tokens, open Settings โ†’ Giving Settings in B1Admin, select the provider, paste in your Public and Private keys, and toggle "Pay Fees" as desired. Finally, configure your fee parameters in Fee Options.

B1Admin Dev Setup

๐Ÿš€ Self-Hosting (Beta)

If you'd like to deploy your own copy on Railway, you can use our template below. This is currently in beta โ€” feedback welcome.

Deploy on Railway

Sponsor this project

 

Contributors

Languages