In our time building apps for customers, we've found ourselves re-rolling some of the same key features over and over again between projects. So we picked some of the things that kept popping up, implemented our own opinionated solutions for them, and then included it all in this free and open-source starter app. We hope it helps you as much as it helps us!
Built-in support for internal emails from the contact form, as well as transactional emails for users.
Hook up to your Stripe account for managing customers and payment sources.
This starter app includes several different page templates (including the one you're reading right now) that you can change as much or as little as you like. If there are any pages you won't need, just remove them.
To get started, do a global find/replace in this project for occurrences of
EOSinaBox and replace them all with the actual name of your app or platform ("Facebag"). Then do the same thing again to replace
EOSinaBox with the actual name of your organization ("Facebag Corporation").
In order for this app to send automated emails, you'll need to create a Mailgun account. Then, in
config/custom.js, configure the following:
// Recipient of contact form messages internalEmailAddress: firstname.lastname@example.org, // For outgoing emails fromEmailAddress: 'email@example.com', fromName: 'The EOSinaBox Team', // Mailgun settings mailgunDomain: 'transactional-mail.example.com', mailgunSecret: 'key-testkeyb183848139913858e8abd9a3'
To enable support for billing features, you'll need to make a Stripe account, then include your test credentials like so:
// Stripe credentials stripePublishableKey: 'pk_test_Zzd814nldl91104qor5911gjald', stripeSecret: 'sk_test_Zzd814nldl91104qor5911gjald'
If your app doesn't need payment processing, it will still work without Stripe configuration. In this case, all references to billing will just be omitted from the UI.
Once the initial configuration is done, you're ready to start building out the rest of your app.
We worked hard to make this starter app's structure consistent and its files are as bare-bones as possible, so it's easy to add new pages and business logic following the conventions we set up. If you run into trouble, have a look at your new FAQ page, which covers the tools we used and how to customize. For a deeper dive, check out the Sails walkthrough, reference documentation and support pages.
We think this project is a pretty convenient starting point, but of course there's no one-size-fits-all solution. The good news is, this app is in your hands now, so you can jump into the files and adapt it to your needs. Change some code around. Break stuff. Fix it. And above all: make something people want to use.