The sky above the ocean A grayish-blue cloud Another grayish-blue cloud A ship hovering a few feet over the surface of the water, bearing a flagpole with the Sails.js logo The shadow of the floating ship on the water

A new Sails app.

Dive in

This is your freshly-generated project + a few extras.

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!

Emails

Built-in support for internal emails from the contact form, as well as transactional emails for users.

Authentication

Ready-to-go, customizable sign up, login, and password recovery flows for your users.

Billing

Hook up to your Stripe account for managing customers and payment sources.

Learn more

How to get started:

computer with email symbol on screen
Set up your branding and content

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 KOPRESS and replace them all with the actual name of your app or platform ("Facebag"). Then do the same thing again to replace KOPRESS.COM with the actual name of your organization ("Facebag Corporation").

This app also includes a default Terms of Use and Privacy Policy. We want to make it easier for apps to be transparent about their users' rights and privacy. But we are developers, not lawyers; and this is definitely not legal advice. Before going live, be sure to replace these example documents with your own company's policies, and seek counsel for assistance if you need to design new terms from scratch.
computer with credit card icon on screen
Configure integrations

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: my.email@example.com,

// For outgoing emails
fromEmailAddress: 'noreply@example.com',
fromName: 'The KOPRESS 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.
computer with sails logo on screen
Customize

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.


Let's get to work.

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.

The Sails Team