appception / appception

Appception

Appception is a web app generator. It allows you to forget about complicated setup and start coding your web app now.

Starting a new application, juggling web, terminal, and text interfaces, is confusing and tedious and frustrating. Appception replaces that experience with a turnkey solution that creates a working, deployed app from nothing fast.

Really fast.

Table of Contents

1. Usage
2. Requirements
3. Development
   1. Installing Dependencies
   2. Tasks
4. Team
5. Contributing

Usage

If you want to use Appception, we recommend you check out the Appception website. You'll need a GitHub account to log in.

Once you log in, you'll see a list of your current GitHub projects. You can select a project/branch or create a new project using one of our generators.

Either way, you're going to end up the file editor! From there just make changes, save, and commit. Easy!

Oh! Did we mention that your project will be automatically deployed on GitHub or Heroku?!

Requirements

• Node 0.10.x
• Bower 1.3.x

All other dependencies are installed with npm, bower, or grunt.

Development

We're honored you'd like to help! Please check out Contributing.

Installing Dependencies

From within the root directory:

sudo npm install -g bower
npm install
bower install

Roadmap

View the project roadmap on waffle.io.

Team

• Wai-Yin Kwan: Scrum Master
• Aaron Melocik: Development
• Kelly Walker: Product Owner

Contributing

See CONTRIBUTING.md for contribution guidelines.

appception's Issues

Only show current projects files in Brackets

User can pick any yeoman template for their base

Server code for serving up Brackets app files

User can save custom file templates

Users can Log In with Github

User can deploy their app to github

Create routing from new project to editing in brackets

Users can customize new projects from images/templates

Code editor is served from the web

This is a potentially difficult technical problem, and probably needs its own issue.

Projects pages doesn't show all the projects.

User can edit HTML/CSS/JS files

Don't necessarily need to be saving edits yet

Azure deployment optimization

Brackets dist: maybe Azure VM that spins up for each client...? Docker?

Files appear in web brackets view

File System Implementation module that conforms with our server/dist

DO NOT upload server/config/(file with passwords) on dist

SUPER IMPORTANT!!!

User can debug/live preview in the app

Changes to made in the IDE are sent to Github during commits.

More file templates, yeoman?

Set up basic file structure

Fix nimble submodule issue

Deploy updated brackets builds? (Add to Grunt tasks? Do manually?)

SECURITY: users can access server files

Need to lock out access to server files with authentication. From https://www.npmjs.org/package/brackets:

"Security Considerations

Authentication and authorization are outside the scope of this module. They should be done by other modules, configured to intercept the request prior to Node-Brackets.

Since Node-Brackets exposes server files for modification over HTTP/HTTPS, it is absolutely critical to properly protect your network or file system. It is strongly recommended not to use this module on production sites, unless you truly understand the security of your system."

Basic styling of app

If user is logged in, / should route to /projects

Save/Load files from Brackets

Create UX Enhancements in IDE

deploy to Azure

404: grunt serve cannot GET /app/app.css

If only the test is looking for this, we can change the test. Otherwise we need to change all hooks.

User can access GH repos from our site

New project creates a new repo in Github

SPEED: Brackets instance has a TON of GET requests, which are synchronous. If we can zip, send the zip, and have the client unzip, this would be faster.

set up Mongo on Mongolabs

New project has template files in it

User can add CSS libraries for styling

favicon: let's have a little icon to represent the app. :)

User can create app with basic yeoman template

User can create a new project

Set up internal test structure

Setup readme and config, basic documentation

move tempfiles from github into client

vendor.js listed multiple times in index.html. Causes Angular load more than once.

Check out Textangular as an alternative (temporary?)

JavaScript or CoffeeScript?

I was trying to start the server, and I got a coffee-script error, which reminded me: any interest in using coffee script?

User can load up GH files for editing

User can npm install (or this is done automatically for them)

Allow users to select repo branches.

warn user before changing project if they haven't committed

QUESTION: Where should files be stored for editing?

Knowing how we plan to store files is necessary for the new shell and also for later optimization. Possible options include:

Remote: our DB,
Remote: direct from GH,
Local: file system (probably not possible),
Chrome: Application Cache,
Chrome: Session Storage,
Chrome: Local Storage,
Chrome: IndexedDB?,
Chrome: Web SQL?

Add more as we get more ideas

Users can commit edits to Github repo