Online tools that let offline groups accomplish greater things. Manage documents, payments, to-dos, calendars, committees, private communication, events, history, polls, maintenance, membership and more in a tool uniquely tailored for condos, HOAs, and neighborhoods. It's the perfect tool for these groups because it's built by board members that use it every day.
This is the code base for the front-end of the Community Ally web-based community management tool. Condo Ally, HOA Ally, Neighborhood Ally, and Block Club Ally use this code base. The back-end server code base is not yet open source.
Using Community Ally
If you're ready to improve your, or your client's, condo association, HOA, or neighborhood, go sign-up immediately at one of the afforementioned sites. It's free, instant, and simple. There's no need for you to build and host your own copy of the application unless you want to customize the site in a way beyond what is already offered.
To develop locally, you'll still need an active Community Ally site setup so you can make requests to the live server. If you haven't signed up for a Condo Ally or HOA Ally site yet, go ahead and do so now. It's instant and free. You're welcome to make a group specifically for development. If that's the case, please put the word "Dev" in your association name during sign-up.
- Clone the repo
- The site uses the subdomain to determine which group you're viewing. For example, https://123fake.condoally.com is for the 123 Fake St Condo Association and https://BrightElm.hoaally.org is for the Bright Elm HOA site. We need to override this logic while you're developing locally so you can specifiy which group to use while hosting off localhost. At the top of website\ngApp\ally-app.ts (Or ally-app.js if you haven't run 'grunt watch' yet), specify the origin of your Ally site in the OverrideBaseApiPath variable.
- Start a local web server in the "website" directory. Make sure HTTPS is supported.
If you want to jump right in to changing the main UI, look in the "website\ngApp\chtn\member" directory. By the way, CHTN stands for condo, HOA, townhome, neighborhood. Those UIs share pretty much the same experience, as opposed to the home and neighborhood watch UI which is mostly separate code. Note in that "member" directory you should be able figure out which page is which by name. If you want to adjust one of the site admin pages, open the "CommunityAllyWebsite\ngApp\chtn\manager" directory.
The main app code is in "website\ngApp". Third-party libraries are in "website\js". The CSS is in the "website\assets\scss" directory, see style.scss for the breakdown.
- Search the project for DEVLOCAL in website\index.html and follow the instructions indicated.
- From a command line, run "npm install" then "grunt watch" in the root directory of the repo.
- Load up the site and verify you can login.
- Changes you make to the Angular templates or code will take effect as fast as Grunt can compile.
Community Ally uses a number of amazing open source libraries:
- AngularJS v1.6 - HTML enhanced for web apps!
- Twitter Bootstrap v4 - great UI boilerplate for modern web apps
- UI-Grid - A datagrid for AngularJS
We can setup, host, and modify custom sites for your community association. Simply contact us here on Github or reach out using the form at the bottom of our home page.