An example Rails 3.2 app for a web startup prelaunch site.
An example Rails 3.2 app for a web startup prelaunch site.
h1. !http://railsapps.github.io/images/rails-36x36.jpg(Rails App for a Startup Prelaunch Signup Site)! Rails App for a Startup Prelaunch Signup Site
Rails 3.2 example application for a “beta launching soon” startup prelaunch signup site.
Best of all, there's a "detailed tutorial":https://tutorials.railsapps.org/rails-prelaunch-signup to show how it is built.
You can build this application in only a few minutes using the "Rails Composer":http://railsapps.github.io/rails-composer/ tool.
!http://railsapps.github.io/images/xplaygrounds-screenshot.png(Rails Application for a Startup Prelaunch Signup Site)!
Read an "interview with Michael Gajda":http://blog.railsapps.org/post/22543541226/powered-up-by-the-railsapps-project-xplaygrounds-com about how he used the project to launch his startup site.
h4. Notable Forks
|. Alternative version |. |_. Author | | "rails-prelaunch-signup-1click":https://github.com/chadokruse/rails-prelaunch-signup-1click | single-click email submit (no modal) | "Chad Kruse":http://twitter.com/chadkruser |
h2. !http://twitter-badges.s3.amazonaws.com/t_logo-a.png(Follow on Twitter)!:http://www.twitter.com/rails_apps Follow on Twitter
Follow the project on Twitter: "@rails_apps":http://twitter.com/rails_apps. Please tweet some praise if you like what you've found.
h2. Introduction
The initial app for a typical web startup announces the founders' plans and encourages visitors to enter an email address for future notification of the site launch. It's not difficult to build such an app in Rails.
But why build it yourself if others have already done so? This project aims to:
By using code from this project, you'll be able to:
h2. What Is Implemented — and What Is Not
This is a complete and fully functional application.
h4. For the user:
h4. For the site owner:
h4. Implementation details:
h4. Tutorial shows how to:
h4. Unimplemented
If you add features or improve the implementation, please consider contributing by submitting an issue or pull request from your fork.
h2. Alternatives
This is an application for Rails developers who wish to deploy their own application. It is a good stepping stone to building a more complex application for your startup. You'll own your own code and can customize to your needs.
Unlike a service such as "LaunchRock":http://launchrock.co/, "KickoffLabs":http://kickofflabs.com/ and "Unbounce":http://unbounce.com/, you'll have your own application you can customize as you wish. Just as important, when your visitors sign up, they are creating real user accounts in a user management system you can use after you launch.
If you do not want to build an application, or you are not a Rails developer, you may wish to consider alternatives.
h3. Hosted Services
h3. WordPress Themes
WordPress themes are a popular way to stage a startup prelaunch page.
h3. Similar Projects
You can find other projects on GitHub that offer similar functionality.
|. Author |. Project |_. Description | | codelitt | "launchpage-rails":https://github.com/codelitt/launchpage-rails | Signup for two different types of users | | johngrimes | "t-minus":https://github.com/johngrimes/t-minus | Instant prelaunch page for your Rails 3 app | | renderedtext | "coming-soon":https://github.com/renderedtext/coming-soon | Sinatra app to show a pre-launch page and collect emails | | hashrocket | "coming-soon":https://github.com/hashrocket/coming-soon | Sinatra app to register email addresses | | jbeyers | "django-prelaunch":https://github.com/jbeyers/django-prelaunch | Django app to gather email addresses with a referral mechanism |
Found others? Please create an issue with your suggestion or email the author.
h3. Articles and Discussion
Here are some articles that describe the purpose and options for a startup prelaunch page:
Have other suggestions? Please create an issue with your suggestion or email the author.
h2. RailsApps Examples and Tutorials
This is one in a series of Rails example apps and tutorials from the "RailsApps Project":http://railsapps.github.io/.
This application is based on two of the RailsApps example apps:
The first example shows how to set up Devise for user authentication. It also shows how to set up the app to use RSpec and Cucumber for testing.
The second example shows how to set up Devise and add CanCan to manage access to administrative pages. It also shows how to set up Twitter Bootstrap as a front-end framework for CSS styling.
You can use this example without studying these example applications; if you find you are lost, it may be helpful to look at the two simpler examples.
If you want to use the MongoDB datastore instead of ActiveRecord and a SQL database, look at "rails3-mongoid-devise":https://github.com/RailsApps/rails3-mongoid-devise example.
h2. Tutorial
An in-depth tutorial is available (subscription required). Subscriptions provide financial support for the RailsApps project.
You can use the starter app without getting the tutorial. The tutorial provides a detailed explanation of the code:
h4. "Get the Tutorial":https://tutorials.railsapps.org/rails-prelaunch-signup
The tutorial documents each step to follow to create the application. Every step is documented concisely, so a complete beginner can create this application without any additional knowledge. However, no explanation is offered for any of the steps, so if you are a beginner, you’re advised to look for an introduction to Rails elsewhere. If you’re new to Rails, see recommendations for a "Rails tutorial":https://tutorials.railsapps.org/rails-tutorial and a list of top resources for "Ruby and Rails":http://railsapps.github.io/ruby-and-rails.html. The article "What is Ruby? And Rails?":http://railsapps.github.io/what-is-ruby-rails.html is a good place to get a basic introduction to Rails.
If you simply wish to modify the application for your own project, you can generate the application and set it up as described below, without following the tutorial.
h2. Dependencies
Before generating your application, you will need:
See "Installing Rails":http://railsapps.github.io/installing-rails.html for detailed instructions and advice.
h2. Accounts You May Need
Before you start, you may need to set up accounts for hosting and email.
h3. Hosting
For easy deployment, use a "platform as a service" provider such as:
Instructions are provided for deployment to Heroku.
h3. Transactional Email
For simple testing of email, it's easy to use Gmail to send email messages from the application. For deployment, when the application must send dozens or thousands of acknowledgments or invitations, you will need a hosted SMTP relay service (also known as an ESP or "email service provider"). We provide instructions for "Mandrill by MailChimp":http://mandrill.com/. The Mandrill transactional email service integrates well with the MailChimp email list manager service. Plus, you can send up to 12,000 emails/month from the service for free.
Sign up for a MailChimp account to get started. After you've created your MailChimp account, see the instructions to "Use Mandrill with MailChimp":http://help.mandrill.com/customer/portal/articles/464750-use-mandrill-with-mailchimp. Then get the "Access Information":http://help.mandrill.com/customer/portal/articles/464828-access-information (your SMTP username and password, which is an API key).
h3. Mailing List
In addition to sending transactional email messages, you likely will want to send newsletters or announcements to your entire mailing list. The tutorial shows how to add visitors who request an invitation to a "MailChimp":http://mailchimp.com/ list. MailChimp allows you to send up to 12,000 emails/month to list of 2000 or fewer subscribers for free. After you sign up for a MailChimp account, get your API key. Look under "Account" for "API Keys and Authorized Apps." Note that the Mandrill API key (which you get on the "mandrill.com":http://mandrill.com/ site) is different from the MailChimp API key (which you get on the "mailchimp.com":http://mailchimp.com/ site).
h2. Getting the Application
You have several options for getting the code. You can fork, clone, or generate.
h3. Fork
If you'd like to add features (or bug fixes) to improve the example application, you can fork the GitHub repo and "make pull requests":http://help.github.com/send-pull-requests/. Your code contributions are welcome!
h3. Clone
If you want to copy and customize the app with changes that are only useful for your own project, you can clone the GitHub repo. You'll need to search-and-replace the project name throughout the application. You probably should generate the app instead (see below). To clone:
$ git clone git://github.com/RailsApps/rails-prelaunch-signup.git
You'll need "g
No open issues yet, or sync has not completed.