icecoder / icerepo

Show diffs, push, pull & sync your site with Github repos

ICEcoder is for sale! Please contact [email protected]. Serious offers only.

---

ICEcoder

Code editor awesomeness ...in your browser

ICEcoder is a browser based code editor, which provides a modern approach to building websites. By allowing you to code directly within the web browser, online or offline, it means you only need one program (your browser) to develop sites, plus can test on actual web servers. After development, you can also maintain the website easily, all of which make for speedy and smart development.

Requirements

You can run ICEcoder either online or locally, on Linux, Windows or Mac based platforms. The only requirement is to have PHP 7 available (7.4 recommended). You can have this either as a vanilla installation or via a program such as WAMP or XAMPP (for Windows) or MAMP (for Mac).

Installation

Step 1: Get ICEcoder

Either download the zip or clone from Github into your wwwroot (document root) dir for your website (this is typically /var/www/html/) via:

$ git clone [email protected]:icecoder/icecoder /var/www/html/icecoder

Step 2: Set permissions on dirs & files

You'll need to ensure both the ICEcoder dir and the wwwroot dir have permissions to read, write and execute. This can be done by changing permissions (using chmod), but it it safer and so better, to use chown:

chown -R www-data.www-data /var/www/html

This will recursively set the www-data user as both the owner and group users for files on the /var/www/html dir (which ICEcoder dir is of course inside of, at say /var/www/html/ICEcoder).

Step 3: Start coding

Now you can visit yoursite.com/ICEcoder to view ICEcoder, sign in and start coding!

Tip: If using ICEcoder locally, you can use:

php -S localhost:8080

...to get PHP to start a simple web server. You can then visit localhost:8080/ICEcoder

Want to setup in other environments?

It's now possible to setup ICEcoder in a Docker container, via Composer, as an executable and more. Checkout https://icecoder.net/downloads for info on these setups!

It's free & open source for everyone!

Suitable for commercial & non-commercial projects, just let us know if it's useful to you and any cool customizations you make to it. We take no responsibility for anything, all usage is all down to you.

It's fully open source and MIT licensed. So we're happy for you to take it, make it your own and customize to your hearts content and/or contribute to this main repo! :)

Plenty of comments included in the code to assist with understanding, customizing etc.

Comments, improvements & feedback welcomed!

icerepo's Issues

Add refresh/reload button

So we don't have to use the browsers reload button. Only reloads the content iFrame.

Pulling & pushing folders

Pushing folders are treated as an empty file. Pulling folders causes a JS error because it think's it is a file.

Need to identify if it's a dir or file and if it's a dir, create tree object on Github (pushing) or create folder on server (pulling).

Don't replace line endings in image content when SHA'ing

It will cause an incorrect SHA. Detect non text file types by MIME. See ICEcoder for this tweak.

Title limit to 80 chars?

Limit the tilte to 80 chars to match GitHub limits.

Pulling changes adds unnecessary backslashes

I pushed a change to my repo and pulled using ICErepo, and there were backslashes before single quotes which broke the JS file. Is this an issue with my setup or ICErepo?

Show git commands on action

Show git commands in console as they're actioned.

Keep diff viewing minimal

Reduce or hide everything apart from diffs in files.

Either reduce the font to something tiny (ie, 6px) and make mid-grey. This allows you to just see the shape of the lines of text that are the same, for visual recognition only. New & deleted lines remain the same (green & red).

Sync instead of commit

This is a feature request rather than an issue. I've not used this yet but I imagine I will be doing quite soon as it seems like a really useful tool.

According to the description am I right in assuming this will only push changes to Github and not vice-versa?
"Those that are only on the server are pushed to Github. Those no longer on the server are removed from Github. Those that have changed are patched over the top of the existing Github held file."

In my work environment I am required to push files from my test server to our versioning software before I push it to the live server and because of that habit I've started adopting the same process with my own projects. A way for me to sync the files from Github to the server as well as from the server to Github would be incredibly useful.

Ask for temp token or username & password

If we don't have oauth or basic auth details in settings file, rather than die, show a form where users can enter the token or username & password combo.

These are then set in session vars and used for the duration of the session only.

This has the benefit of not having your details stored anywhere.

Adding new files using repo.write

You can add new files using repo.write according the github.js manual. However, this doens't seem to be working and is returning an error. Asked Michael to have a look into this and fix.

Filetypes and logo update

Update filetypes image to cover new filetype list supported by ICEcoder.

Also perhaps update logo.

Adding multiple changes as 1 commit

When you select multiple files/folders and commit, it addes them one by one, a commit for each.

Would be good if we could commit multiple files/folders under just the one.

Ask to create dir or repo if not available

On load/switching repos, if the dir or repo doesn't exist, ask user if we want this created.

Image upload diff issue? Should also show old and new images

Image uploaded (a PNG) had 0 bytes. Need to fix this.

Should also show old and new images rather than text & text diffs.

Use fileinfo_mime instead of fileinfo_mime_type

fileinfo_mime_type is only available on PHP 5.3+