Basics
Your first project
Create a project, write some code, run it and save a version.
Create a project
Choose New project… on the welcome screen (Ctrl+Shift+N). Pick a template — Empty, Python, Node.js, C++, Web or Java — give it a name, and Kiln creates the folder (in KilnProjects in your home folder by default) and opens it.
For something more complete, use Start from a template to choose one of the project templates.
Write and run code
The Python starter asks for your name and greets you. Open main.py and press F5:
def greet(name: str) -> str:
return f"Hello, {name}!"
if __name__ == "__main__":
who = input("What's your name? ")
print(greet(who))The terminal opens, the program asks for your name, and you can type the answer right there. When it finishes you’ll see the exit code and how long it took. Press Shift+F5 to stop a program that’s still running.
When something goes wrong
If the program crashes or doesn’t compile, Kiln reads the error output and puts a red marker on the exact line in your code. The Problems tab (Ctrl+Shift+M) lists every error. Ask Sakura (Ctrl+Shift+H) → Why won’t my code run? explains the error in plain language.
Files and folders
- Press Ctrl+N for a new file. You can type a path like
src/util.pyto create folders at the same time. - Right-click in the explorer to rename, duplicate, delete (to the trash) or reveal files.
- Drag files between folders to move them. Open editors follow the file.
- Files are saved automatically a moment after you stop typing.
Save a version with git
- Open Source control (Ctrl+Shift+G) and click Initialize repository.
- Type a commit message and click Commit all changes (Ctrl+Enter).
- Change a file, then click it in Changes to see a side-by-side diff.
To put the project on GitHub, add a token in Settings → Git, then choose Publish to GitHub.